Prr 


para quem conhece 


Recursos avançados para a criação 
de Websites dinâmicos 


o| 
|) 
| al 


Juliano Niederauer 


PHP 


para quem conhece 


Recursos avançados para a criação 
de Websites dinâmicos 


o| 
|] 
| al 


Juliano Niederauer 


Novatec 


Copyright © 2008 da Novatec Editora Ltda. 


Todos os direitos reservados e protegidos pela Lei 9.610 de 19/02/1998. É proibida a 
reprodução desta obra, mesmo parcial, por qualquer processo, sem prévia autorização, por 
escrito, do autor e da Editora. 


Editor: Rubens Prates 

Editoração eletrônica: Carolina Kuwabata 
Revisão gramatical: Patrizia Zagni 

Capa: Edinei Gonçalves 


Primeira/segunda edição: ISBN: 85-7522-044-6 
Terceira edição: ISBN: 978-85-7522-165-5 


Novarec Eprrora LTDA. 

Rua Luís Antônio dos Santos 110 

02460-000 — São Paulo, SP Brasil 

Tel.: +55 11 2959-6529 -> 

Fax: +55 11 2950-8869 

E-mail: novatec@novatec.com.br 

Site: www.novatec.com.br a 
CBO bb 


O 


STA 
DOS. 4 


Dados Internacionais de Catalogação na Publicação (CIP) 
(Câmara Brasileira do Livro, SP, Brasil) 


Niederauer, Juliano 

PHP para quem conhece PHP : recursos avançados 
para a criação de websites dinâmicos / Juliano 
Niederauer. -- 3. ed. -- São Paulo : Novatec 
Editora, 2008. 


ISBN 978-85-7522-165-5 


1. Banco de dados 2. Internet (Rede de 
computadores) 3. PHP (Linguagem de programação 
pera computadores) 4. Web sites - Criação 
I. Título. 


08-06828 CDD-005.133 


Índices para catálogo sistemático: 


1. PHP : Linguagem de programação : Computadores 
Processamento de dados 005.133 


vDC20100311 


Dedico este livro às duas pessoas mais importantes da minha vida. À quem soube 
educar, dar bons exemplos e ajudar em minha formação ética e moral, além de estar 
sempre presente quando precisei. A quem me possibilitou estudar, pois o sucesso não 
depende apenas de capacidade, mas também de oportunidade. A quem se preocupa, 
aconselha, incentiva e muitas vezes coloca a felicidade dos filhos acima da sua 
própria felicidade. O mínimo que posso fazer é dedicar esta obra aos meus pais, 
Cícero e Mariza. 


“O que é escrito sem esforço é geralmente lide sem prazer” 
- Samuel Johnson 


Sumário 


Agradecimentos................... sr ererrererreeasareneesereneerencaserenrereserreressasasoreasesenvaenaesenararças 15 
Sobre O autor ........sssesertaserrerenensereasessencerencesencererercecerercarareecereresseser ease re rcaserensasa santas 16 
Introdução... esses erereerererererereaeareraserosereacarececerererenceracerasesererencesesasarananensa 17 
Quem deve ler este livro... eee cet ee ee aaeraeaere terrena nerenennta 18 
Como este livro está organizado ........i cer eeeearereaeeenastiresereass 18 
Download do código-fonte do livro... eee ceeeceeteenos 20 
Capítulo 1 : Revisão de PHP ..................... rs irerereneeeerrareenseserenserereerererensarenses 21 
Iniciando em PHP... cerne career SEEE ESANERA rear EPERE EEAEE TEESE 21 
Embutindo PHP na HTML... erica a teresa rare ereeeanas 23 
Exibindo a página no navegador... enereerecteeeateeaseraneeeasenanas 24 
Constantes.....iiisisisiereeereere resete cao re reta rena nana ana n ana a nana cenenacacreeaereerererereacera 25 
Variáveis ...cccctene nen treat arte rtr aanan care cenaa renan aatoaeae cama eeraananeecerenennnanaseseaana 27 
Escopo das variáveis.........ienetireeteeeerereenecerenaeeenanereeacamecaeaeeenerereneos 28 
Variáveis geradas dinamicamente .........sscseesiirererrrrtrttrrsrrstirirtetetsrretrerrrtt ttn 29 
ÅTTAYS ..cerecttiterirarieneaaneneerererreeacacananaaaae eee rareeniananeasenacacasaeanenaaanacaeceeeataei 29 
Objetos... rerreeene aerea aterrar aaa aaea cane eaara cera taeea enter aeee teen EEEren EEEE 32 
Operadores... steecereramrieecrenerteea tera tnter EIEE EE EEEE reracareeneaerarenesennenanacanas 32 
ATIIMÉŁİCOS......seesessssetssttt stts test atr Art III IE A EE EEEE E arena aaa rerenerrerereaeterereno 33 
Binários.........ciicesecrta caca cencecera nana eraa rt EAP NEEESE SEAEPEEAPEEAEEIPSTEEEEEENEEEA EEES SERES 34 
Comparação ....ssssssasissssssnsniristrestrrertererrenni aurea EPEEEEEEEEEEES EEren EEEa rAr E EEEE 35 
Atribuição ....sssnsnssseoarsssuinitstttittt tutes ttt rErE tern ienana rate a aaa caneca e treeeasteeaeenanieos 35 
Lógicos... ereta eeeeeneoootooeeeecacarenanarerereannanenamnanaranaaennaaeetenanas 37 
Precedência de operadores... ieeteei terra rteeeearerer tree stireereees 39 
Estruturas de controle em PHP... eeeetreeseeeenarerenneeennos 4 

if 4l 
SWILCÍ..... irei iiertererarerereeererererenaeecanereaaa renan renaenaanaeaaenacasaeatanenaceneenenanenenas 43 

while... terrena se teieenaasareren ar aeenena near arara na ceree nana tera a aerea arena 44 

do... while... iss crer teeeree ater aiaa atear teen a na tareea sacana o erereaa 45 

tor 45 
foreach ......i ts it eieseeeena sarna cen tens EEES EEAS EEEEEErSNEEEEEEPSEEEENEESEEEENE EEEE EENE EESE 46 


8 PHP para quem conhece PHP 


Capítulo 2 Melhorando o processamento de formulários... 51 
Criação do formulário ....... riren ra n n aaan E Ea n 51 
Enviando as informações para um programa PHP... 54 

Método GET... 55 
Método POST... 56 
Os arrays superglobais $ GET e $ POST... 57 
Funções especiais para formatação de dados... 57 
Validação no cliente com JavaScript... 60 
Validação no servidor com PHP... 62 
Espaços em branco... 63 
Número mínimo de caracteres... 63 
Campos de e-mail... 64 
Numéricos... teia 65 
CPF. 66 
CNP) ue 67 
Exemplo de validação de dados... 69 

Capítulo 3 Mantendo informações com cookies e sessões..............mmemmeees 75 
Por que usar cookies e sessões? ernn nannan 75 
Utilizando cookies... 76 

Invasão de privacidade?........ aaan an 77 
Enviando cookies pelo PHP... 78 
O array superglobal & COOKIE... 79 
Autenticação de usuários... 80 
Criando um sistema de username/senha para seu site... 81 
Utilizando sessões... 87 
O que é uma sessão? ........ a 87 
Propagando o identificador entre as páginas... 88 
Criando uma sessão no PHP... 88 
Registrando variáveis em uma sessão ........ ore oerni nan 89 
Parâmetros de configuração... 91 
Usando sessões no sistema de username/senha o.an 92 
Funções do PHP para manipulação de sessões... 96 

Capítulo 4 - Arquivos-texto: praticidade e rapidez... ermmeeeeeremees 99 
Por que utilizar arquivos no PHP?....... rnn 99 
Operando sobre arquivos ........ totae ne erinan nnan anaana 100 

Abertura «eee aaa 100 
Fechamento... 102 
Leitura... teen ceaaitaaia aaa, 102 
Escrita... eee carai PA AEAEE EPERE KEEKEEKE EEEE E EEEa an 106 
Criando um contador de acessos niinen nnan 107 


Sumário 


Capítulo 5 - A página envia o e-mail ........ssssseesssssssesssesesssstessreesrreresserossrresnseveorenneesseeeee 117 
Por que enviar e-mails com o PHP? .........i is cretenetenceeracenneeenceeass 117 
Quem envia o e-mail?........s teres creereeesaeeaaaesaeeaaceea rem narencacanaeranens 118 
Utilizando a função mail .....s.ssseeeseeeieseeireireseretersrttttereerenstinististeretrsttetettn tna 19 
Diretivas de configuração no php.ini..........cisestseesceceeeeneeneeererceneeeeencaicnaa 119 
Composição de uma MeEnSageEM........ssssssisertrerrietrresrrirerirertrsristererettntetsteertttt: 120 
Adicionando informações ao cabeçalho do e-mail..........sssseesssiiies DI 
Enviando e-mails em formato HTML... iseeeseererecereeanenenastrananeem 122 
Exemplos de envio de e-mails com o PHP... 123 

Coletando as sugestões de seus visitantes .........ciiieeseeeasesessesanseeeeennteeenatos 123 
Mensagens para diferentes áreas da empresa .....sscerererenereirinrerennentere 126 
Lista dos cabeçalhos de e-mail (mail headers)... 129 

Capítulo 6 - Enviar arquivos? Faça Upload! .........essssseesssssesssserssrsresssereussecennneeseseesernresas 131 
Por que fazer upload de arquivos? ........sseseerseisrisisetrerersrrtettettitesstisstitrt tettette 131. 
Diferenças entre os protocolos HTTP e FTP... sisters 132 
Upload utilizando PHP e HTTP... stiteascireneeaencanaeeacanenaenaretenes 133 

Definindo o formulário HTML... tieseerenseceeerenenaeaeeacarenaos 134 
Parâmetros de configuração do upload .............seseaessasscsesereerenane 136 
Recebendo e gravando O arquivo... ieeeeceseaeiaeenesanceneeeeeenaents 137 
Upload utilizando PHP e FTP... iiiecieaeaaiereeereeacenacenacetenateneaos IH 
Definindo o formulário HTML... reeestcereeeaanacareanananess 141 
Configuração do servidor e do upload ............csiissessictenecenentenes 142 
Conectando ao servidor e enviando o arquivo .......ssserereeereereeetrerrrerrnee 143 
Enviando múltiplos arquivos ...s..ssssseeesssssserreristirtirttrerssrisrisrirtttstrtrrsnntntt tn Ettn E = 146 
Utilizando variáveis em segiiência ........iieteeeseereeaerenaeesantatieneneees 147 
Utilizando um array... eecrtetaceocreccetaeeneaeaeecaeeaeeneanaaaacentea 150 
Problemas comuns..........icicieteeteeateeee carona crenacereeeacerenaeeeasateanantemenaco 152 
Mensagens de erro... iissieseeeraeerenarereenecenaasenenareenereeeanetenaneerenna 153 
Funções de FTP disponíveis no PHP............... eeereneaereeeeneecereeeeaencementeneane 154 

Capítulo 7 A arte de gerar imagens no PHP.............. Cereerereereraareeeereneasa see neaeanasesnseseneaa 158 
Por que manipular imagens?.........stieeseesesctereseteeeaeeeetaraeeaateenentarensereneneos 158 
Introdução à biblioteca gráfica GD .........i ss eeseesasesatasceeeneeennerenaaernans 160 

Tipos de imagens suportados ..........cesitetetenesacesteseeneenrenacecenaeeaeranents 160 
Criando uma imagem ......iteterecericeaere cores eeareeenerenesenaaaanaaeanacenaea 161 
Definindo as cores... tera t r ntti nE ttrt tE Sranan EEan ES SEE ns EErEE 162 
Definindo o conteúdo .....s...ssissieisriserissrrrstrirstrererirttsaserssrrsrrnrattes terret ereet 163 
Exibindo a imagem... renteereerecceeeseeareranaaaaiaatenaceneecenacamanta 164 
Liberando a memória utilizada... cicestereneereneseceeearereraceeenaa 166 
Desenhando elementos gráficos básicos... sseeseemesassieeaaeeesereeeetnees 166 
Linhas... teeaetasiios teorema ESPASE EEEEEEEEP E NESEEEEESEEEEEEESASEE SEEE EEEEE ENESE EEES 166 
Retângulos ...s.sesessisiseisessiesirirererirsrerstrtreretsstistesrtrstrantinitrtenatta tinet ra tEn 168 
Polígonos........eterseeetareatariaaeroeerceea rama terte rtrar tatt s EE ernt EnS En Enen r EEEE 170 


10 PHP para quem conhece PHP 


Círculos e eclipses... 175 
Escrevendo em uma imagem ..... e 178 
Usando a fonte-padrão ......... is 179 
Usando fontes TrueType... ee 181 
Exemplos de aplicações... 183 
Contador de visitas gráfico... 183 
Marcador de imagens para websites... 190 
Miniaturas (thumbnails) de imagens... 195 
Gráficos em formato de pizza ......i es 203 
Gráficos de colunas... 215 
Gráficos de linhas... 228 
Funções do PHP para manipulação de imagens... 234 
Capítulo 8 - À versatilidade dos documentos PDF ................c cs ssrrereerersereerereersereness 248 
Por que criar documentos PDF?......i e 248 
Introdução à biblioteca PDFHD ....... ese 250 
Formas alternativas: Haru e FPDF ........ rs 250 
Criando um arquivo PDF... 251 
As propriedades do documento... 252 
Adicionando páginas ao documento... 252 
Escolhendo o tipo e o tamanho da fonte .......i 254 
Inserindo o conteúdo... 255 
Fechando o documento e liberando a memória... 256 
Definindo o destino do documento gerado ©... eerren 256 
Sistema de coordenadas... 258 
Inserindo caixas de texto no documento ........iiii 261 
Formatando O texto... aeee 263 
Inserindo imagens no documento... 266 
Desenhando em um documento... 268 
Linhas e curvas... iii eder een 269 
Rerângulos e quadrados... 271 
Círculos € arcos... aires 272 
Definindo um modelo (template) para as páginas... 274 
Inserindo referências no documento .........iiii 276 
Bookmarks... atenas ea eee eee 
Miniaturas (thumbnails) 
Weblinks... aeee eat 
Programa-exemplo com referências... 279 
Exemplos de aplicações com a PDF... 281 
Conversor TXT para PDF... certo 281 
Relatórios PDF a partir de consultas SQL... 285 
Exemplos utilizando a FPDF ........... ts 292 


Funções do PHP para manipulação de documentos PDF... 295 


Sumário 


Capítulo 9 - Utilizando modelos: seja “Smarty” .................s ss ieceerererereenaa 310 
Por que utilizar modelos (templates)?.......... eee 310 
As ferramentas existentes ...... ici tastet tristie t EErEE EAS EES PEONES rrer EEE snte 311 
Smarty — A ferramenta de modelos ......ssssscsssssssrissstresriissriisrriiserirrrriserirrere renin 3 

O que é Smarty? ..... errar enatarear aeee eee cana cante ENAERE EEEn neat 312 
Download e instalação... nerer area erenieeenarerereranarereeaaa 313 
Incluindo uma chamada para a classe... 314 
Estrutura da aplicação ......... ice teeetaeareaaeaea cerne eanaaranearantaiara 314 
Testando a ferramenta... renecereereneaeaareeananeetaean a careeraanttio 316 
Informações sobre o layout... cecetereneeirereeeareenertians 317 
Delimitadores......... crer ee cera saeaia cares e reranteaeaeaeera trans 317 
Comentários... ce tera tara tera n ea anna renan trace nana nana 317 
Funções... citreearearaeeeeananea tera r eco r aa aaa aerea tera nanaararas 318 
Atributos... reeeaterea to reeae can aaeee re aiac arena naen ana cana ar eeenra anna arres EErEE Ea 318 
ETSE AS CE 319 
Modificadores de variáveis... iiarentaeeearencerarerraeaeo 320 
Arquivos de COnfiguraçÃO....s...ss.ieeeieseriesristtisttte rttr trisat tiesti ranir tari errereen rrtt 324 
Informações sobre a programação PHP... 327 
A constante SMARTY DIR... erra eerenaaaaa aee reaeeneereriana 327 
Variáveis de configuração .........secieeereeeieerre aeee cerca res camaras 328 
Métodos... ietrereeteereeaaarcerena na aeaerra nas tera aa ca rancor ana naninen ni rracananaa 331 
Exemplos de aplicações com Smarty... 332 
Catálogo de livros... sirene ereena terrena ca cereranaaaaariea nar ceriea 332 
Sistema de notícias........iiisiiteeeeeeinereaaaeenacerteea ca raeeeiananecaaiaanaeceteo 337 
Funções da Smarty para a criação de templates ...........ciiiiien 344 
Embutidas......... resiste eeateaseaeee cena naiiaaaeen arcar ntaea ceara 344 
Personalizadas ..........cs eins iirenttee arara nateeanaere cas aeen scene caaiiarireranees 351 
Métodos da classe Smarty para o PHP ..... eae 367 

Capítulo 10 - Acesse um banco de dados! Não importa qual.............................s.. 373 
Por que usar abstração de banco de dados? .......... eee 373 
Bibliotecas disponíveis .........iiiii eee encare trr nani aanrens 375 

Extensão dbx......... ereta acena reenea teres erre caes cerenenea 375 
As classes PEAR::DB e PEAR MDB... 376 
Comparação das bibliotecas ...........iirrereeeereraacerenanaeraraaa 376 
Utilizando a extensão dbx ........eeeicerereacacarenetererenenaeerenenaa 376 
IEIET EOE OREN 377 
Conectando ao banco de dados... teresa eee 377 
Executando consultas SQL... eternas 379 
Manipulando os resultados da consulta... 380 
Encerrando a conexão... ciietes crises irei carenennas ir ereancaneatenaaaniios 381 
Exemplos utilizando dbx.......... eee reeaeeeees 382 
Utilizando a classe PEAR::DB.........i sirene sie eeeantriiaa 394 
O que é PEARP..i en 394 


Instalação do pacote DB ou MDB2.......... eee 394 


12 PHP para quem conhece PHP 


Incluindo a chamada para a classe... 396 
DSN — Data Source Name ....... e 396 
Conectando ao banco de dados... 397 
Executando consultas SQL... 398 
Modos de busca do resultado... 399 
Outras funções úteis para retorno de dados seiis 401 
Encerrando a conexão... 402 
Exemplos utilizando PEAR::DB ©... rnrn nnn 403 
Exemplo com a classe PEAR::MDB2......... no rirrirnrnnn 409 
Funções do PHP para a extensão DBX ......... rnrnnnnnn 410 
Funções da extensão PEAR::DB......... ornini r nir nininini 411 
Classe DB... 412 
Classe DB Common... 412 
Classe DB Result... 415 
Capítulo 11 + Estudo de caso: controle de finanças .......ssssssesesesesessrsesessssesesensssssasrsosnsse 417 
Definição do sistema... 417 
Criando a base de dados ......... rnern ninine 420 
Include de acesso ao banco de dados... 421 
Autenticação do usuário com cookies ........ rnn annen nun 422 
LES io EESO 423 
Autenticação... 424 
Logout... tear re eeaeaaer ereta iara eae 425 
Opções do menu principal... 425 
Inclusão de receitas e despesas... 428 
A planilha de receitas e despesas... 432 
Escolhendo o período de visualização... mente 432 
Exibindo a planilha... 434 
Gerando um gráfico de despesas... 442 
Gerando um relatório PDF para O Mês... crnca 446 
Enviando os dados por e-mail... 451 
Exclusão dos dados cadastrados ........ nnn 454 
Apêndice A Comandos gerais do PHP........sssssssanoooosesssssssssssersecresreosnsnsssssnrnrerrsronsssssens 457 
ÅTTAYS ..icoccssetrerinetemeae terrena areias 457 
Classes e objetos... e 460 
CHbPDE SESAO 460 
Data e hora... 463 
ADX.. etica aaa aaa 464 
Diretórios... eita iaaaaiace eae aeee 465 
PTP SET 465 
Funções... aeee aeee, 466 
ATT eae aeee 467 
Imagens... eee eae 467 


IMAP, POP3 e NNTP e 470 


Sumário 


InterBase... retratar errar ieaeaeeeesaeetenenenananannanananananaanananineo 473 
Matemática........isitieeeeenerereeeeeeeteranana na reeereraceeeteceeecenereraneaaaaaiananannananaanas 474 
Microsoft SQL Server ......ssessssesossseissttitt tettert titen ritt EESE ne EPESA EEEE EEEa rrer errre 476 
MSQL..sisssisssiissiistsistis stiot t attit t AEEA S EES EEEEEEESEEESEEEIENEEPANEAENE ANENE RETENE ETEE ESEE EEEE 477 
naO O 478 
SAOI E E 480 
OCIB POSNETO 482 
(O) DIe ORDER 484 
Opções e informações do PHP... iereeeeeesereeeteneetaenesasaraseninseerennos 485 
(OTETO CEOE 487 
ADI SEO 488 
PostgreSQL... siste e creeteneneaeanaaaatarenanacacereannacenenaneracenanacarerananaos 491 
SESSÕES ...icireeerstiiisiienenniaarerererrereeea nana aerea cearea rea nano eareerierenaenaanaaaaeesenanasaniananasa 494 
Sistema de arquivos (Filesystem) ..........sssseeeeteeseeeeecetaranaeeenenecintteneas 495 
SINES... erereacocreeerecereeanereenenaaaaeaeenanaecaraneacemenaneceanenncraranenaneraraeeos 497 
Sybase... eee racer eeteaeriareacecera toners eaeecaaeaeeaenaaeacananaaaaaantanenencees 500 
[05 56 O 501 
ESEE AACD 501 
Apêndice B - Novidades do PHP 5 e PHP 6.....ssseesssssesusseesssersesseereueseessreressseoresrereseeeeense 503 
O que mudou a partir do PHP 52... sis ieaeesteeeaccentereneeeeneenateaa 503 
PHP será uma linguagem orientada a objetos?.........sisteeeeseeeereeeeneecensamenos 504 
Compatibilidade entre as versões 4,5 € 6... iscissiessssssiascceesceecereneeeenneranam 504 
As principais novidades ...........cieeciteeeeeseenaeaceacaeaneanaeeseneniacaaeatencenneoo 505 
Orientação a objetos... ierterenrrerenceeenaereeeaeemenaerencecencasaa 505 
SQLite ......iiiiieeeeceeeererecerararirinaearerererereneeaeaarananaanananoccaaaaanaaaenta 513 
Suporte XML... cetterirerenacenena cera naeeenananannaceeena cena aeaeeantamanaa 54 
Outras mudanças ........creieoiteeeataenanoaeeeaereanareeanaceeeacenenneremacaanas 514 
Apêndice C » Links interessantes .....eessessssesesessesssessreeseversnsessneesseessresserrereerreeesrerreeenreess 519 
Site oficial do PHP... tentenee tarte eeeeaneraancraeaceeaneneaeancenenda 519 
Scripts, programas e tutoriais PHP ................. cerereeriai r renananaaeenerenenanerananantos 519 
Catálogos de links PHP... ie teeeseeeerasanamneanataeraneeceeencenarentea 520 
Outros links... science teor eeeaeaeea ai aeea eres arerenaeeeacerenaeaeeacanas 520 


Índice remissivo ....s...eseenssssrenssseoeossnesessesensssoronesnressstroussetosstirossuteesstsessssiennusteesererssseeos 521 


Agradecimentos 


Gostaria de agradecer especialmente a todos aqueles que acreditam nos autores 
nacionais. Apesar de a maioria das novidades do mundo tecnológico surgir em 
outros países, o Brasil possui muitos autores capazes de transmitir conhecimentos 
com qualidade igual ou superior à dos estrangeiros. Além disso, os livros nacionais 
não possuem o problema das traduções técnicas deficientes, o que ocorre com fre- 
quência em nosso mercado editorial. Obrigado por valorizar nossos autores! 


15 


Sobre o autor 


Juliano Niederauer (http://ww.niederauer. com.br) é graduado em Ciência da Com- 
putação pela Pontifícia Universidade Católica do Rio Grande do Sul (PUCRS) e 
pós-graduado (MBA) em Gestão Empresarial, com concentração em Tecnologia 
Aplicada a Negócios. É diretor da Virtuous Tecnologia da Informação (http://www. 
virtuous.com.br), empresa que desenvolve projetos educacionais na área de TI. Possui 
ampla experiência no desenvolvimento de aplicações para a web, tendo ministrado 
diversos cursos de PHP em universidades e empresas. Já criou sites de sucesso na 
web, sendo o principal deles o maior portal matemático do mundo, o Só Mate- 
mática (http://www. somatematica.com.br), que hoje conta com mais de 3 mil páginas 
de matemática e mais de 6 milhões de page-views mensais. Possui conhecimentos 
profundos sobre as linguagens PHP, ASP e sobre o desenvolvimento de programas 
em ambiente CGI utilizando a linguagem PERL. Possui ainda conhecimentos sobre 
bancos de dados relacionais, incluindo MySQL, PostgreSQL, InterBase e Oracle. 
Pode ser contatado pelo e-mail julianofniederauer. com.br. 


16 


Introdução 


Em 1995, quando Rasmus Lerdorfcriou para uso pessoal uma ferramenta chamada 
PHP/FI (Personal Home Page/Forms Interpreter), talvez não imaginasse que esta- 
ria criando o que hoje se tornou um fenômeno em termos de desenvolvimento de 
aplicações na web. O PHP foi uma das linguagens de programação voltadas para a 
internet que mais cresceu nos últimos anos em todo o mundo. 


A quantidade, diversidade e qualidade de seus recursos, assim como a facilida- 
de de utilização, foram os principais fatores que alavancaram seu uso em grande 
escala. A prova desse crescimento está nas estatísticas publicadas pelo site Netcraft 
(http://www. netcraft. com). No início de 1999, pouco mais de 50 mil domínios utiliza- 
vam a linguagem PHP, enquanto, no início de 2007, esse número já ultrapassava 20 
milhões. 


O número de scripts PHP disponíveis na internet já supera o de outras linguagens 
bastante conhecidas, como ASP, Java, Python e Perl. Diversos sites disponibilizam 
scripts PHP gratuitamente, os quais possuem as mais variadas funcionalidades, 
como, por exemplo, contadores de acesso, sistemas de votação, salas de bate-papo, 
fóruns de discussão, processadores de formulários, entre outras. 


Enfim, o PHP conquistou muito espaço nos últimos anos. As empresas perce- 
beram esse rápido crescimento e cada vez mais estão considerando-o a melhor 
alternativa para o desenvolvimento de suas aplicações web. Um fato que comprova 
essa afirmação é que muitas empresas estão criando cursos internos para treinar 
seus funcionários, que em muito pouco tempo poderão estar aptos a lidar com 
essa poderosa linguagem e desenvolver qualquer tipo de sistema para atender às 
necessidades da organização. 


Para estar habilitado a atender a qualquer tipo de necessidade, seja pessoal, seja 
empresarial, além de aproveitar ao máximo os poderosos recursos do PHP, torna-se 
necessário adquirir um conhecimento mais profundo dessa linguagem. Fornecer 
um pouco desse conhecimento adicional é o principal objetivo deste livro. 
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Quem deve ler este livro 


Este livro destina-se, principalmente, a pessoas que já conhecem o PHP, mas que 
desejam aprofundar-se um pouco mais no estudo dessa linguagem. Porém, para 
aqueles que tiveram pouco contato com o PHP, o livro contém um capítulo que 
apresenta uma boa revisão da linguagem, muito importante para que os usuários 
menos experientes adquiram os conhecimentos básicos, visto que em seguida serão 
apresentados alguns assuntos não triviais, como upload de arquivos, manipulação 
de imagens, criação de documentos PDF, abstração de bancos de dados, entre 
outros. 


Para quem nunca teve contato com o PHP nem noção alguma de como instalá- 
lo e utilizá-lo, é recomendável eferuar a leitura de um livro básico que ensine os 
aspectos mais elementares da linguagem, como Desenvolvendo Websites com PHP, 
da Novatec Editora. 


Por se tratar do mesmo autor, a metodologia utilizada aqui será a mesma do 
Desenvolvendo Websites com PHP. Se você já o leu, verá que aqui a didática também 
é o ponto forte. A abordagem dos temas é clara, objetiva e as explicações são dadas 
passo a passo, para facilitar o aprendizado. 


Como este livro está organizado 


Com exceção do primeiro capítulo do livro, que contém uma revisão da linguagem, 
cada um dos demais aborda um tema avançado de programação PHP Um detalhe 
importante a se ressaltar é que não há uma ordem recomendada para a leitura 
dos capítulos, visto que a maioria dos assuntos abordados é independente entre 
si. Portanto, não há necessidade de ler o livro em sequência; você pode ir direto ao 
capítulo de seu interesse no momento. A seguir é apresentada uma rápida descrição 
dos conteúdos abordados. 


= Capítulo 1 — Revisão de PHP: contém uma revisão da linguagem, apresentando 
sua sintaxe básica e ensinando a utilizar constantes, variáveis, operadores 
e estruturas de controle (como if, switch, while e for). Mostra também como 
realizar operações sobre um banco de dados MySQL. 


= Capítulo 2 — Melhorando o processamento de formulários: ensina a criar formulários e 
como dar um tratamento adequado às informações submetidas pelo usuário. 
Mostra como aplicar validações tanto no lado do cliente como no lado do 
servidor. Além disso, apresenta algumas funções para formatação dos dados 
recebidos por meio de um formulário. 
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= Capítulo 3 - Mantendo informações com cookies e sessões: explica a utilidade dos 
mecanismos de cookies e sessões oferecidos pelo PHP, além de ensinar as 
principais funções utilizadas para implementá-los. Explica também como 
realizar autenticação de usuários, assim como a criação de um sistema de 
usuário/senha. 


= Capítulo 4 — Arquivos-texto: praticidade e rapidez: mostra como utilizar arquivos no 
formato texto para armazenar dados e recuperá-los rapidamente, sem que 
haja necessidade de se conectar a um SGBD (Sistema Gerenciador de Banco 
de Dados). Explica em que situações é interessante realizar a manipulação de 
arquivos e apresenta as principais funções disponíveis no PHP para executar 
essa tarefa. 


= Capítulo 5 — A página envia o e-mail: ensina a utilizar o recurso de envio de e-mails 
oferecido pelo PHP, Explica a utilidade de enviar e-mails por meio de seus 
programas, além de como utilizar a função que executa essa tarefa. Mostra 
também como usar o formato HTML para formatar as mensagens. Ao final do 
capítulo, apresenta exemplos de aplicações e a lista dos principais cabeçalhos 
de e-mail existentes. 


= Capítulo 6 — Enviar arquivos? Faça Upload!: ensina passo a passo como utilizar os re- 
cursos do PHP para fazer o upload de arquivos (enviar um ou mais arquivos 
de um computador local para um computador remoto). Explica também em 
que ocasiões se utiliza essa operação. 


~ Capítulo 7 — À arte de gerar imagens no PHP: explica todos os passos básicos para a 
criação de imagens no PHP, assim como para a alteração de imagens já exis- 
tentes. Apresenta também as funções responsáveis por desenhar os elemen- 
tos gráficos básicos, além de exemplos de aplicações que podem ser criadas 
usando a biblioteca gráfica disponível para o PHP. 


= Capítulo 8 — À versatilidade dos documentos PDF: mostra como utilizar o PHP para 
gerar documentos no formato PDF (Portable Document Format). Apresenta 
todos os passos básicos para a criação desses documentos, assim como os 
principais recursos disponíveis na biblioteca PDFlib, como formatação, caixas 
de texto, modelos, inserção de imagens, entre outros. 


=- Capítulo 9 — Utilizando modelos: seja “Smarty”: explica a utilidade das ferramentas 
de modelos (template engines) disponíveis para o PHP, além de ensinar a 
programar com uma das mais utilizadas, a Smarty (http://smarty.php.net). 
Fornece informações sobre a instalação, sintaxe, variáveis, funções e diversos 
exemplos para facilitar a compreensão dessa ferramenta. 
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Capítulo 10 — Acesse o banco de dados! Não importa qual... explica a utilidade das 
bibliotecas de abstração de banco de dados existentes para o PHP além de 
ensinar a criar aplicações utilizando algumas delas. Apresenta todos os passos 
necessários para operar sobre um banco de dados, como a abertura da cone- 
xão, execução de consultas SQL, obtenção dos resultados e encerramento da 
conexão. 


Capítulo 11 — Estudo de caso: controle de finanças: ensina a criar um sistema de con- 
trole de finanças com o PHP. Para isso, utiliza diversos recursos que foram 
abordados no decorrer do livro, como validação de campos de formulários, 
manutenção de informações com cookies, criação de gráficos, geração de 
relatórios PDF, abstração de banco de dados e envio de e-mails. 


Apêndice A — Comandos gerais do PHP: apresenta a descrição dos principais comandos 
do PHP. Pode ser utilizado como referência. Os comandos foram divididos em 
diversas categorias, como arrays, strings, variáveis, funções, classes e objetos, 
matemática, data e hora, sistema de arquivos (filesystem), diretórios, HTTP, 
FTP, URL, imagens, opções e informações do PHP, entre outras. 


Apêndice B — Novidades do PHP5 e PHP6: mostra as principais mudanças ocorridas 
nas últimas versões do PHP, além de abordar a questão da compatibilidade 
entre diferentes versões. Contém também exemplos de códigos que implemen- 
tam novas funcionalidades de orientação a objetos do PHP, como variáveis 
privadas e protegidas, construtores e destrutores, exceções, constantes, entre 
outras. 


Apêndice C — Links interessantes: indica diversos links para você se aprofundar 
ainda mais no estudo da linguagem PHP e de outras tecnologias. Os sites 
recomendados oferecem diversas ferramentas úteis para o desenvolvimento de 
sites dinâmicos e interativos, como tutoriais, scripts gratuitos e documentação 


detalhada. 


Download do código-fonte do livro 


O código-fonte dos exemplos apresentados neste livro está disponível para download 
no site da Novatec Editora, no seguinte endereço: 


http://vemw.novatec. com.br/download/phpavancado 


Nesse endereço, você encontrará um arquivo compactado contendo os programas 


PHP separados em diretórios. Cada diretório contém o conjunto de programas 


referentes a um capítulo do livro. 


Revisão de PHP 


Este é um livro que aborda tópicos avançados da linguagem PHP (ww. php.net). Porém, 
para você que teve pouco ou nenhum contato com essa linguagem, este capítulo será 
de grande importância, visto que contém uma revisão de PHP, apresentando sua 
sintaxe básica e ensinando a utilizar constantes, variáveis, operadores e estruturas 
de controle (como if, switch, while e for). Além disso, será mostrado como realizar 
operações sobre um banco de dados MySQL, que é um sistema bastante utilizado 
com o PHP Se você é um programador mais experiente, pode passar diretamente 
ao Capítulo 2. 


Iniciando em PHP 


Um programa PHP pode ser escrito em qualquer editor de texto, como, por exemplo, 
o Bloco de Notas (Notepad), do Windows, ou o Vi, do Linux. Já existem também 
diversos editores específicos para o PHP, que exibem cada elemento (variáveis, textos, 
palavras reservadas etc.) com cores diferentes, para melhorar a visualização. 


Um trecho de código PHP deve estar entre as tags <?php € ?>, para que o servidor 
web possa reconhecer que se trata de um código de programação e possa chamar 
o interpretador PHP para executá-lo. Para começar a treinar, abra o editor de texto 
de sua preferência e digite as linhas a seguir: 


<?php 

// legal, estou escrevendo meu primeiro programa em PHP 

echo "<hl align='center'>Este é meu primeiro programa!</h1>"; 
?> 


Salve esse programa como progl.php e envie-o para o diretório que você está 
utilizando para hospedar o site. Esse programa vai gerar como resultado a frase 
"Este é meu primeiro programa!" centralizada na página, conforme mostrado na figura 
LI. Para ver o resultado, basta você acessar pelo navegador (browser) o endereço 


21 


22 


PHP para quem conhece PHP 


http: //<seu endereço>/progl. php, onde você deve substituir <seu endereço» pelo endereço 


do servidor que está utilizando para executar os programas PHP. 


Favoritos Ferramentas Ajuda 


E] Concluído 


pod EE Intranet local 


Figura 1.1 — Resultado do programa prog1. php. 


A seguir é apresentado o significado de cada uma das linhas que você digitou 


no programa prog1. php: 


Elemento 


Descrição 


<?php 
// 


echo 


?> 


Indica o início de um trecho de código PHP. 


Representa uma linha de comentário. Tudo que vem após essas barras 
na mesma linha é ignorado pelo PHP. Os comentários são muito úteis 
para uma boa documentação de seu programa. As duas barras servem 
para transformar uma única linha em comentário, mas você pode usar 
/* para iniciar uma seguência de comentários e, depois, finalizar os 
comentários com */. 

Trata-se de um dos comandos mais utilizados em PHP Serve para 
escrever algo na tela. 


Indica o término de um trecho de código PHP 


Se você escolher a opção Exibir-Código-fonte em seu navegador, verá o código 


que seu browser recebeu, que foi o seguinte: 


<hl align='center'>Este é meu primeiro programa!</h1> 


Note que o navegador não recebe nenhuma linha em PHP, somente o código 


HTML puro. Isso acontece porque o PHP roda no servidor, que processa todos os 


trechos de programação e retorna somente o resultado final para o navegador. 


Quando as páginas possuem extensão . html, o servidor web as tratará como HTML 
puro e não reconhecerá códigos PHP. Se a página possuir extensão . php, o servidor 
web irá testar linha a linha em busca de códigos de programação, por isso o processo 
torna-se um pouco mais lento. Por essa razão, só coloque extensão . php nas páginas 
que realmente possuem códigos PHP, senão você estará desperdiçando tempo ao 
procurar a cada linha códigos que não existem na página. 
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Em relação à velocidade de processamento, podemos fazer uma pequena compa- 
ração entre o PHP e a linguagem ASP (Active Server Pages), da Microsoft. Mesmo que 
as páginas .php demorem um pouco mais para ser processadas que as páginas com 
HTML puro, diversos testes realizados por programadores americanos comprovaram 
que são processadas muito mais rápido do que aquelas que usam programação ASP. 
Além disso, o PHP possui um gerenciamento de memória superior ao do ASP. 


Embutindo PHP na HTML 


Normalmente uma página PHP não contém apenas códigos de programação PHP, 
mas também tags de marcação HTML. Enquanto o PHP representa a parte dinâmica 
da página, a HTML representa a parte estática. Ou seja, toda vez que você acessar a 
página, a saída HTML será a mesma, enquanto a saída gerada pelos códigos PHP 
pode ser diferente a cada acesso. 


As tags HTML devem aparecer fora das tags <?php e ?>, pois estas delimitam um 
trecho de programa PHP. Dentro dessas tags até podem aparecer tags HTML, mas 
somente se utilizarmos um comando de exibição (como o echo) para escrevê-las. 


Você pode concatenar scripts PHP com tags HTML, podendo, dessa forma, escre- 
ver vários trechos de código PHP em uma única página. Cada script PHP existente 
na página deve começar com a tag <?php e terminar com ?>. À maioria das linhas 
de programação que serão escritas entre as tags deve terminar com o caractere ; 
(ponto-e-vírgula), senão ocorrerão erros no momento da execução da página. Entre 
essas tags, você pode escrever programas utilizando todos os recursos que o PHP lhe 
oferece, como definição e chamada de funções, acesso a banco de dados, atribuição 
de valores a variáveis, fórmulas matemáticas etc. 


Essa combinação entre HTML e PHP é muito útil, pois utilizamos o PHP para 
gerar os dados de forma dinâmica, enquanto o HTML é utilizado para formatar e 
exibir esses dados nas páginas mostradas no navegador. 


Vamos ver um exemplo que mistura HTML e PHP para mostrar a data atual. 
Digite o seguinte programa em seu editor de textos e salve-o como prog2.php: 


<html> 
<body> 
<?php 
Sdata de hoje = date ("d/m/Y",time()); 
?> 
<p align="center">Hoje é dia <?php echo $data de hoje; 7></p> 
</body> 
</html> 
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Note a combinação existente entre as tags HTML e o código PHP No início do 
programa, atribuímos a data atual à variável $data de hoje, utilizando o comando 
date. Essa variável estará disponível para uso em qualquer parte da página. Depois 
utilizamos HTML para escrever a frase "Hoje é dia” e completamos abrindo um 
novo trecho de PHP, escrevendo a data atual armazenada na variável $data de hoje 
por meio do comando echo. 


Exibindo a página no navegador 


Para o navegador mostrar qualquer coisa na tela é necessário que a página tenha 
pelo menos um comando de exibição (como o echo) para escrever algo ou, então, 
comandos HTML que escrevam o conteúdo da página. Porém, somente se for usado 
o comando echo ou algum outro comando PHP que produza uma saída na tela, você 
realmente terá informações dinâmicas, pois o HTML é estático e imprime sempre 
as mesmas informações na tela. Veja o seguinte exemplo: 


<html> 
<body> 
<?php 
$base = 10; 
faltura = 20; 
$area = $base * $altura; 
?> 
</body> 
</html> 


Salve esse programa como prog3.php € veja o resultado em seu navegador. Perceba 
que não há nenhum comando echo no programa, por isso seu navegador mostrará 
uma tela em branco. Os valores atribuídos às variáveis ficaram armazenados apenas 


na memória, mas não foram mostrados na tela. Ao visualizar o código-fonte recebido 
pelo navegador, você verá apenas as tags do HTML: 


<html> 
<body> 
</body> 
</html> 


Vejamos agora um exemplo parecido com o anterior, mas dessa vez vamos utilizar 


o comando echo para mostrar informações na tela. Digite o seguinte programa em 
seu editor de textos e salve-o como prog4. php: 


<html> 
<body> 
<?php 
$pais = "Brasil"; 
Sfrase = "O $pais é pentacampeão mundial de futebol"; 
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echo “<h2 align=center>Sfrase</h2>"; 
?> 
</body> 
</html> 
Abrindo essa página em seu navegador, você obterá o resultado exibido na 
figura 1.2. 


http://localhost? 


«H Voltar 


|| Endereço E hitp 


g4. php 


O Brasil é pentacampeão mundial de futebol 


#J Concluído o TT EB intranet local 


Figura 1.2 — Resultado gerado pelo programa prog4. php. 
Com esses exemplos você descobriu duas informações fundamentais: 


1. Aimportância do comando echo: para gerar dados dinâmicos é fundamental 
dominar esse comando ou algum outro que produza saída na tela. 


2. Ainterpolação de variáveis: daqui em diante você vai usar muito essa técnica. 
Trata-se da inclusão do valor de uma variável dentro da outra, como, por 
exemplo, em nosso programa prog4.php, na variável chamada $frase, incluímos 
o valor da variável $pais. Ou seja, dentro da string que é atribuída a uma va- 
riável, podemos colocar outra variável é, no momento do processamento do 
programa, o PHP irá substituir a variável por seu valor. 


Como veremos no tópico Variáveis, é importante lembrar que em PHP as variáveis 
começam sempre pelo símbolo de cifrão ($). 


Constantes 


São valores que são predefinidos no início do programa e que não mudam ao longo 
de sua execução. Você pode definir suas próprias constantes utilizando o comando 
define. Leve em consideração que, por padrão, o PHP diferencia letras maiúsculas de 
minúsculas. O nome da constante deve ser referenciado no programa exatamente 
do mesmo modo que você a definiu. A sintaxe do comando define é a seguinte: 


bool define (string nome, misto valor [, bool case insensitive]) 
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Onde nome é o nome que você vai utilizar para representar a constante, valor é um 
valor qualquer (numérico ou alfanumérico) a ser atribuído a ela e case insensitive é 
um valor lógico (true ou false) que indica se o PHP deve diferenciar letras maiúsculas 
de minúsculas quando houver uma referência a essa constante. Veja o exemplo a 
seguir, nomeado como prog5.php, que mostra como devemos usar as constantes: 


prog5.php 


<html> 

<body> 

<?php 
define ("meunome”,"Juliano Niederauer"); 
define ("peso",78); 


echo "O meu nome é " . meunome; . 

echo "<br>"; 

echo "O meu peso é " . peso . " quilos"; 
?> . 
</body> 
</html> 


Executando esse programa, você terá o seguinte resultado em seu navegador: 


O meu nome é Juliano Niederauer 

O meu peso é 78 quilos 

Note que, no exemplo que acabamos de ver, referenciamos as constantes dire- 
tamente pelo nome que escolhemos, e não utilizamos na frente delas o símbolo $, 
pois esse símbolo é utilizado apenas para representar variáveis. 


Outro recurso que utilizamos neste exemplo foi a concatenação, representada 
pelo ponto (.). Podemos concatenar quantos dados quisermos, e todos eles serão 
exibidos como apenas uma seguência de caracteres. 


Além de você poder definir suas próprias constantes, o PHP já possui diversas 
constantes predefinidas. A tabela a seguir mostra algumas delas: 


Constante Descrição 

TRUE Valor verdadeiro (utilizado para comparação). 

FALSE Valor falso. 

FILE Contém o nome do script que está sendo executado. 

INE Contém o número da linha do script que está sendo executado. 


PHP VERSION Contém a versão corrente do PHP. 

PHP OS Nome do sistema operacional no qual o PHP está rodando. 

E. ERROR Exibe um erro ocorrido em um script. A execução é interrompida, 

E WARNING Exibe uma mensagem de aviso do PHP. A execução não pára. 

E PARSE Exibe um erro de sintaxe. A execução é interrompida. 

E NOTICE Mostra que ocorreu algo, não necessariamente um erro. A execução 


não pára. 
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Variáveis 
As variáveis servem para armazenar dados que podem ser usados em qualquer 


ponto do programa. Cada variável está associada a uma posição de memória de 
seu computador. 


Ao contrário de linguagens tradicionais, como C, Pascal e Delphi, no PHP não é 
necessário declarar variáveis. Basta atribuir diretamente um valor a estas e, a partir 
desse momento, já estarão criadas e associadas a um tipo (numérico, alfanumérico 
etc.), dependendo do valor que lhes foi atribuído. 


Vimos que em PHP as variáveis devem iniciar com o símbolo $. Após esse sím- 
bolo, deve vir o identificador da variável, ou seja, o nome pelo qual será referencia- 
da durante a execução do programa. Esse identificador não pode iniciar com um 
número. Os números podem aparecer em qualquer posição do identificador, menos 
na primeira. Exemplos de variáveis válidas e inválidas: 


» Válidas 


$notal 

$casal20 

$bisc8 
$gremio_2_vezes_campeao_america 


= Inválidas 


$100vergonha 
$5 
$20assustar 
$60nacadeira 


É recomendável que você utilize sempre identificadores com letras minúsculas, 
pois o PHP faz a distinção entre maiúsculas e minúsculas. Se você misturar os dois 
tipos de letras, poderá confundir-se ao utilizar as variáveis, já que $nota aluno não é 
a mesma coisa que $Nota aluno. 


Imagine se um aluno tirou nota 10 e esse valor foi armazenado na variável $nota. 
aluno. Na hora de imprimir a nota do aluno, você digitará a seguinte linha: 
<?php 


echo $Nota aluno; 
?> 


O aluno será reprovado, pois você imprimiu a variável errada. Portanto, tome cui- 
dado: o PHP distingue letras maiúsculas de minúsculas para nomes de variáveis. 
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Escopo das variáveis 


Em relação ao escopo, quando uma variável é utilizada dentro de uma função, pode 
haver uma outra variável com o mesmo nome sendo utilizada em outra função ou 
no código do programa principal. São espaços de memória diferentes, e cada um 
funciona dentro de seu contexto, ou seja, a variável definida dentro da função só 
pode ser acessada ali dentro. Fora dali, seu valor não é acessível em nenhuma outra 
parte do programa. 


No entanto, é possível usar dentro de uma função o valor de uma variável exis- 
tente também no programa principal. Para isso, há duas formas: 


1. defini-la como global no início da função; 


2. utilizar o array predefinido SGLOBALS, que utiliza os nomes das variáveis como 
chave associativa. 


Como exemplo, acompanhe o programa prog6.php: 


progó.php 


<?php 
$num = 5000; 
function testa escopol O 
{ 
global $num; 
$num += 5; 
echo $num . "<br>"; 


} 


echo $num . "<br>"; 


testa escopol(); 
?> 


Ao executar esse programa, serão mostrados os seguintes valores na tela: 


5000 
5005 


Isso ocorreu porque no início da função testa escopol se indicou que a variável 
$num era a mesma utilizada globalmente. Desse modo, todas as alterações feitas na 
variável $num dentro da função, alteraram o valor que existia nessa variável global. Se 
retirássemos da função a declaração global, a variável $num não seria reconhecida. 
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Em diversas ocasiões é muito útil criarmos variáveis dinamicamente, ou seja, durante 
a execução do programa. Essa técnica funciona assim: utiliza-se o valor de uma 
variável para servir como identificador para outra que é criada. Para isso, utilizamos 
duas vezes o símbolo $, ou seja, devemos usar $$. Acompanhe o exemplo a seguir: 


& prog7.php 


<?php 
$nome = “Juliano”; 
$futuro identificador = "autor"; 
$$futuro identificador = $nome; 


at 


echo "O nome do autor é "; 
echo Sautor; 
?> 


Ao executar o programa prog7.php em seu navegador, você verá a seguinte frase: 


O nome do autor é Juliano 


Veja que a variável Sautor foi criada dinamicamente. Primeiro o valor “autor” foi 
atribuído à variável $futuro. identificador e, depois, com o uso de $$, o valor “autor” 
tornou-se o identificador da variável recém-criada. A variável criada $autor recebeu 
o valor da variável $nome e, em seguida, seu conteúdo foi mostrado na tela após a 


frase "O nome do autor é 


Guarde bem esse conceito de variáveis com nomes dinâmicos, pois existirão situ- 
ações em que esse recurso poderá ser a única solução para resolver um problema. 


Arrays 


As variáveis comuns (também chamadas de variáveis escalares) podem armazenar 
apenas um valor por vez. Um array (vetor) pode armazenar vários valores ao mesmo 
tempo, pois trata-se de uma estrutura de armazenamento que, assim como as va- 
riáveis, possui um identificador, mas além disso há um índice associado (que pode 
ser um número ou um texto), e cada índice indica uma posição de memória em 
que fica armazenado um elemento do array. O índice deve aparecer entre colchetes 
(1]), logo após o identificador do array. 


Vamos ver um exemplo para você entender melhor o conceito de array: na en- 
trada de um edifício, há um daqueles armários com diversas gavetas para guardar 
correspondências, uma para cada apartamento. Podemos comparar o armário com 
o array, e os apartamentos com os índices do array. Ou seja, existe apenas um nome 
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identificador, que é o armário, mas, se um morador do edifício chega para pegar 
suas correspondências, ele deve acessar a gaveta correspondente a seu índice, que 
é o número de seu apartamento. 


Os arrays são muito úteis quando precisamos realizar automatização de tarefas 
em nossos programas. Imagine que os nomes de todos os moradores de um edifício 
devem ser mostrados na tela. 


Obviamente não seria viável que unlizássemos variáveis escalares para armazenar 
os nomes. Se fossem 60 nomes, teríamos 60 variáveis, e para mostrar os valores na 
tela, deveríamos usar 60 vezes o comando echo. Mas se os nomes dos 60 moradores 
estivessem guardados em um array, bastaria que utilizássemos um comando de 
repetição (que veremos mais adiante) para imprimir desde a primeira posição do 
array até a última, ou seja, variando q índice de O a 59. Veja a seguir alguns exemplos 
de armazenamento em arrays: 


$vetor [0] = 30; 
$vetor [1] = 40; 
$vetor[5] = 50; 
$vetor[15] = 60; 


Il 


Se não colocarmos o índice do vetor entre colchetes, o PHP irá procurar o último 
índice utilizado e incrementá-lo, armazenando assim o valor na posição seguinte 
do array, conforme mostra o exemplo a seguir: 


$vet[ ] 
$vet[ ] 


"Grêmio"; 
"Campeão"; 


Nesse exemplo teremos o valor “Grêmio” armazenado em $vet[0] e o valor “Campeão” 
armazenado em fvet [1]. 


Até agora só vimos exemplos em que o índice do array é um valor numérico, 
mas o Índice também pode ser um texto, e nesses casos o texto é chamado de chave 
associativa: 

Svetor["time"] = "Grêmio"; 


$vetor["titulo"] = "Tetracampeão da Copa do Brasil"; 
$vetor["ano"] = 2001; 


Repare que cada posição do array pode ser de um tipo diferente. Os valores das 
posições referenciadas por time e título são do tipo string, mas o valor da posição 
referenciada por ano é numérico. Outra situação que pode ocorrer é o array possuir 
índices numéricos e strings ao mesmo tempo. Não há problema algum em usar os 
dois tipos de índices no mesmo array. 
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Existem também as matrizes, que são arrays multidimensionais. Essas estruturas 
de armazenamento também contêm um único identificador, mas possuem dois 
ou mais índices para referenciar uma posição de memória. Imagine que queremos 
armazenar na memória os nomes dos melhores clubes do futebol brasileiro, separan- 
do-os por estados e cidades. Podemos fazer isso utilizando um array bidimensional, 
como mostra o exemplo a seguir: 


$clube ["RS"] ["PortoAlegre"] = "Grêmio"; 
fclube ["RS"] ["Caxias"] = "Juventude" 

fclube ["RS"] ["BentoGoncalves"] = "Esportivo"; 
$clube ["MG"] ["BeloHorizonte"] = "Atlético"; 
$clube ["MG"] ["NovaLima"] = "Vila Nova”; 
$clube ["MG"] ["Ipatinga"] = "Ipatinga"; 

$clube ["SP"] ["SaoPaulo"] = "Corinthians"; 
$clube ["SP"] ["Americana”] = "Rio Branco"; 


Esse exemplo mostra um array bidimensional, mas podemos usar arrays com 
mais de duas dimensões, bastando acrescentar mais colchetes com seus respectivos 
índices. Outra forma de criar um array é por meio da função array do PHP. Veja o 
exemplo prog8.php, apresentado a seguir: 


prog8.php 


<?php 
$vetor = array (10,50,100,150,200): 
echo $vetor[2] . "<br>"; 
$vet = array (1, 2, 3, “nome"=>"Joaquim"); 
echo $vet[0] . "<br>"; 
echo $vet["nome"]; 
?> 


Após a execução desse programa, os resultados mostrados na tela serão os 
seguintes: 


100 
1 
Joaquim 


Lembre-se de que o array é iniciado na posição O (zero), por isso, apesar de ser 
o terceiro elemento do array, o 100 foi o primeiro valor mostrado, pois seu índice 
é 2. Depois se criou um array que possui índices numéricos e também uma chave 
associativa. Com o uso do comando echo, mostramos na tela os valores de duas 
posições desse array. 
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Objetos 


Também é possível programar em PHP com o modelo orientado a objetos. Podemos 
definir uma classe e, dentro dela, as variáveis e funções que estarão disponíveis a 
seus objetos. Um objeto é a variável que utilizamos para instanciar uma classe. Se 
você alguma vez já estudou programação orientada a objetos, esse conceito deve 
lhe ser familiar. Veja um pequeno exemplo: 


<?php 
class teste 
{ 
function Saudacao() 


{ 


echo "01 pessoal!"; 


} 
} 
$objeto = new teste; // $objeto se torna uma estância da classe teste 
$objeto -> Saudacao(); 


?> 


Ao criar uma instância da classe na variável $objeto, podemos acessar as funções 
definidas dentro da classe. Esse programa mostrará a mensagem "0i pessoal!". 


Uma das principais novidades do PHP 5 é o novo modelo de orientação a obje- 
tos. À partir dessa versão, o PHP passa a operar com a Zend Engine 2.0. Para obter 
mais informações, consulte o Apêndice B deste livro, que apresenta as principais 
novidades desse novo modelo. 


Operadores 


Como o próprio nome indica, os operadores informam ao PHP quais operações 
devem ser executadas com os valores recebidos, como, por exemplo, atribuir um 
valor a uma variável, realizar operações aritméticas (soma, subtração etc.), realizar 
comparação de valores, testar se um é maior ou menor que o outro etc. Veremos os 
seguintes tipos de operadores: aritméticos, binários, de comparação, de atribuição, 
e ternário. 
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Aritméticos 


Utilizando esses operadores, você poderá efetuar qualquer operação matemática 
com dados do tipo numérico, como, por exemplo, somar, subtrair, multiplicar, dividir 
etc. Confira a tabela com os operadores aritméticos do PHP: 


Operador Operação 

+ Adição 

- Subtração 
Multiplicação 

/ Divisão 

% Resto da divisão 


O PHP possui também outros operadores aritméticos que atuam em apenas um 
operando. Esses operadores são bastante úteis, pois nos permitem realizar de forma 
simples operações, como troca de sinal, incremento ou decremento de valor etc. 


Se você já programou em linguagem C, deve lembrar-se do incremento utilizando 
o operador ++. No PHP também é possível utilizá-lo. Vamos conhecer todos esses 
operadores com a tabela a seguir: 


Operador Descrição 

-oper Troca o sinal do operando. 

++oper Pré-incremento. Primeiro incrementa o valor do operando e depois 
realiza a operação. 

--oper Pré-decremento. Primeiro decrementa o valor do operando e depois 
realiza a operação. 

oper++ Pós-incremento. Primeiro realiza a operação e depois incrementa o 
operando. 

oper-- Pós-decremento. Primeiro realiza a operação e depois decrementa o 
operando. 


Os operadores apresentados nessa tabela também são conhecidos como ope- 
radores unários, pois necessitam apenas de um operando, ao contrário da adição, 
subtração e outras operações que necessitam de pelo menos dois operandos. 


Por exemplo, se o objetivo for somente incrementar o valor de uma variável, 
pode-se simplesmente digitar o nome da variável seguida do operador ++. 


Exemplo: 


$contador++; 
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Na verdade, esses operadores que acabamos de ver deixam seu programa muito 
mais simples em PHP, pois com o uso deles você pode fazer em apenas uma linha 
de código o que faria em duas ou mais linhas se não os usasse. Ao entender como 
funcionam, seus códigos ficarão mais simples e claros. 


Binários 

Esses operadores atuam em um nível de abstração bem mais baixo: trabalham 
diretamente com bits. Podem ser utilizados para fazer comparações binárias (bit a 
bit), inverter os bits de um operando, deslocar bits para direita (cada deslocamento 
para a direita equivale a uma divisão por 2) ou esquerda (cada deslocamento para 
a esquerda equivale a multiplicar o número por 2). Em alguns casos é interessante 
usar os operadores binários. Veja a tabela a seguir para conhecê-los: 


Operador Descrição 


-0p1 Inverte os bits de op1. 

op1 & op2 Operação E (AND) bit a bit. 
opl | op2 Operação OU (OR) bit a bit. 
opł ^ op? Operação OU exclusivo (XOR). 
opl >> n Desloca op1 n bits à direita. 


opl << n Desloca op1 n bits à esquerda. 


Veja um exemplo: 


prog10.php 
<html> 
<body> 
<?php 

$num = 50; 


$deslocado = $num >> 1; // desloca 1 bit para direita 


echo $deslocado; 
?> 


</body> 
</html> 


No exemplo apresentado, o valor 50 (que equivale a 110010 na base binária) é 
deslocado um bit à direita, o que equivale a dividi-lo por 2. O resultado escrito na 
tela será a divisão de 50 por 2, que dá 25 (equivalente na base binária a 11001). 


Perceba que o número que vem após o operando >> representa o número de bits 
que o operando será deslocado para a direita. Portanto, se tivermos o número 2, o 
número será dividido por 4 (duas divisões sucessivas por 2). Se após o operador >> 
houver um número n, estaremos dividindo o operando por 2". 
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Comparação 


Também chamados de condicionais. São aqueles que executam comparações entre 
o valor de duas variáveis, ou de uma variável e um texto, ou uma variável e um 
número. Com eles podemos testar, por exemplo, se uma variável possui um valor 
maior que o da outra ou se possui um valor maior que o de um determinado 
número, ou se o retorno dado pela chamada de uma função é verdadeiro ou falso. 
Veja a tabela a seguir: 


Operador Descrição 

opl == op? Verdadeiro se op1 for igual a op2. 

opl === 0p2 Verdadeiro se op1 for igual a op2 e se ambos forem do mesmo tipo. 

opl >= op? Verdadeiro se op1 for maior que ou igual a op2. 

opl <= op? Verdadeiro se op1 for menor que ou igual a op2. 

opl != op? Verdadeiro se op1 for diferente de op2. 

opl !== 0p2 Verdadeiro se op1 for diferente de op2 ou se ambos não forem do 
mesmo tipo. 

op1 <> op2 Também serve para representar diferença. 

opl > op2 Verdadeiro se op1 for maior que op2. 

op1 < op? Verdadeiro se op1 for menor que op2. 


O operador de comparação == pode ser usado tanto na comparação de números 
como na comparação de textos, ao contrário de outras linguagens, que utilizam 
comandos específicos para comparar dados alfanuméricos. 


Atribuição 


Atribuição é o termo utilizado para representar a colocação de um valor em uma 
variável. A variável que receberá a atribuição encontra-se sempre do lado esquer- 
do do operador, e esta recebe o valor gerado pela expressão ou operador que está 
à direita. Além disso, temos diversas variações dos comandos de atribuição que 
podemos utilizar para facilitar a programação. São operadores que, assim como os 
operadores de incremento (++) e decremento (--), servem para deixar o código mais 
simples e mais fácil de ser programado. 


Veja a seguir a tabela dos comandos de atribuição: 


Operador Descrição 


opl = op2 opl recebe o valor de op2. 
opl += op2 Equivale a opl=opl+op2. 
op1 -= op2 Equivale a opl=op1-op2. 
opl *= op? Equivale a opl=op1*op2. 
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Operador Descrição (cont.) 

opl /= op? Equivale a opl=op1/op2. o 
opi .= op? Concatenação: equivale a opl=op?.op2. 
op1 %= op? Equivale a op1=op1%op2. 


opl <<=0p2 Equivale a opl=opi<<op2. 


opl >>= op2 Equivale a opl=opl>>op2. 


opl & op? Equivale a opi=opi&op2. 


opl |= op? Equivale a opl=opi/op2. 


opl ^= op? Equivale a opl=opl4op2. 


Muitas vezes programas podem apresentar problemas em razão da troca do operador 
de comparação == pelo operador de atribuição =. O programa acaba gerando resultado 
incorreto, pois se quisermos fazer uma comparação, por exemplo, entre as variáveis 
$a e $b, deveremos usar a expressão $a==$b, e não $a=$b. 


Vamos ver um exemplo envolvendo operadores de atribuição: 


prog11.php 

<html> 

<body> 

<?php 
$soma = 0; 
Svalorl = 10; 
$valor2 = 20; 
$valor3 = 30; 
$soma += $valor1; // $soma fica com 10 
$soma += $valor2; // $soma fica com 10+20 = 30 
fsoma *= $valor3; // $soma fica com 30*30 = 900 
$soma %= 100; // $soma fica com 900%100 = 0 
echo S$soma; 

?> 

</body> 

</html> 


Como você 


pode ver pelos comentários do programa, o valor que será mostrado 


na tela é zero. O último operador utilizado (%-) representa o resto da divisão (em 


outras linguagens é chamado de MOD). Dividindo 900 por 100 temos como resul- 


tado exato 9, portanto o resto da divisão é zero. No exemplo anterior, utilizamos os 


entre a própria 
claro e fácil de 


operadores +=, *- e % para atribuir à variável $soma resultados de operações realizadas 


variável $soma e outro operando. Perceba que o código fica bem mais 
entender com o uso desses operadores de atribuição. 
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Lógicos 
São aqueles que retornam o valor verdadeiro ou falso. Veja a tabela: 


Operador Descrição 


!op1 Verdadeiro se op1 for falso. 

op1 AND op2 Verdadeiro se op1 E op2 forem verdadeiros. 
op1 OR op2 Verdadeiro se op1 OU op2 forem verdadeiros. 
op1 XOR op2 Verdadeiro se só opł ou só op2 for verdadeiro. 
op1 && op2 Verdadeiro se op1 E op2 forem verdadeiros. 
op1 || op2 Verdadeiro se op1 OU op2 forem verdadeiros. 


Depois de observar essa tabela, você provavelmente está com dúvidas quanto à 
diferença entre os operadores AND e &&, e também os operadores OR e ||. À diferença 
entre eles é a precedência dos operadores na avaliação de expressões. A precedência 
mais alta é dos operadores && e ||, enquanto os operadores AND e OR possuem pre- 
cedência mais baixa. Por isso, tome muito cuidado ao usá-los, pois podem gerar 
resultados diferentes, dependendo da ordem em que forem colocados. Veremos mais 
diante um tópico especial sobre precedência de operadores. 


Um exemplo típico no qual usamos operadores lógicos é o caso de testar se todos 
os campos obrigatórios de um formulário foram preenchidos. Suponha termos um 
formulário em que os campos nome, e-mail e CPF são obrigatórios. Certamente no 
programa que recebe os dados do formulário haverá um teste, como o mostrado 
no trecho de programa a seguir: 


<?php 


if (empty($nome) OR emptyCSemail) OR empty($cpf)) 

{ . 
echo "Você deve preencher os campos nome, e-mail e CPF!”; 
exit; 


?> 


Nesse exemplo, temos uma expressão sendo avaliada. A função empty OO, que sig- 
nifica vazio em português, retorna verdadeiro se a variável estiver vazia e falso se 
houver algo na variável. Então, estamos testando se a variável $nome está vazia ou a 
variável $email ou a variável $cpf está vazia. Se pelo menos uma das três estiver vazia, 
o resultado será verdadeiro, e isso fará que seja impressa a mensagem “Você deve 
preencher os campos nome, e-mail e CPF!” e, logo após o programa, será encerrado 
por meio do comando exit. 
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Acompanhe as tabelas a seguir para ver os resultados gerados em cada um dos 


operadores de acordo com o tipo de expressão avaliada: 


Operador ano (E) 


Operador or (OU) 


Operador xor (OU exclusivo) 


Operador ! (NOT) 


Expi Exp? Resultado 
V V V 
V F F 
F V F 
F F Eo 
Expl Exp2 Resultado i 
V voio y 
V F | 
F V i V 
F FO F 
Expl Exp? | Resultado 
V F 
V | F V 
F | V | V 
Foi F Fo 
Expi Resultado 
V F 
F V 
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Ternário 


É uma forma abreviada de usar o comando condicional if, que veremos mais adiante. 
Uma condição é avaliada e, caso seja verdadeira, atribui-se um valor à variável, e 
caso seja falsa, atribui-se um outro valor. À sintaxe é a seguinte: 


cond? expl : exp? 


Vamos ver um exemplo de uso desse operador, embora seja mais recomendado 
utilizar o comando condicional if, por ser mais simples. Observe: 


$nota = ($frequencia >= 0.75) ? ($nota+2) : ($nota-2); 


Quando o PHP executar a linha anterior, se a variável $frequencia possuir um valor 
maior que ou igual a 0,75, a variável $nota será aumentada de duas unidades, caso 


contrário haverá a diminuição de duas unidades. Escrevendo essa mesma operação 
por meio do comando if, temos o seguinte código: 
<?php 
if ($frequencia >= 0.75) 
$nota = $nota+2; 
else 


$nota = fnota-2; 
?> 


Utilizando o comando if, torna-se bem mais fácil entender qual é o objetivo 
do código, pois conseguimos distinguir perfeitamente qual é a condição e quais 
operações serão executadas após a avaliação desta. 


Precedência de operadores 


Para evitar erros de lógica em programas, é fundamental que você conheça a ordem 
utilizada pelo PHP para tratar os operadores. A tabela a seguir mostra a ordem 
decrescente de precedência que o PHP segue ao encontrar diversos operadores no 


programa: 
Operador g Descrição i i 
new Criação de objetos. 
[ Colchete. 


I ~ + -- (int) (float) 


(string) (array) 
(object) @ Não-lógico, inversão de bits, incremento e decremento, 
conversão de tipos e controle de erro. 


/ % Multiplicação, divisão e resto da divisão. 
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Operador Descrição (cont.) 

+=- Adição, subtração e concatenação. 
<< >> Deslocamentos binários. 

> < >= «= Maior, menor, maior ou igual, menor ou igual. 
== [= © === |= Igual e diferente. 

& AND binário. 

A XOR binário. 

| OR binário. 

&& AND lógico. 

lI OR lógico. 

?: Operador ternário. 

= 4 -= % J= % 

b= ~= <= >= ^= Operadores de atribuição. 

print Impressão. 

AND AND lógico (de menor prioridade). 
XOR XOR lógico (de menor prioridade). 
OR OR lógico (de menor prioridade). 

, Vírgula. 


É importante lembrar que primeiro o PHP executará todas as operações que 
estiverem entre parênteses. Se dentro dos parênteses houver diversas operações, 
a precedência de operadores será usada para definir a ordem. Depois de resolver 
todas as operações que aparecem entre parênteses, o PHP resolverá o resto da ex- 
pressão baseando-se na tabela anterior para determinar a ordem de avaliação dos 
operadores. 


Quando houver operadores de mesma prioridade em uma mesma expressão, e 
não existirem parênteses, o PHP resolverá a expressão da esquerda para a direita. 


Observe o seguinte trecho de programa: 


Em progl2.php 


<?php 
$num = 5; 
$resultado = 8 + 3 * 2 + +$num; 
echo “$num<br>": 
echo $resultado; 
?> 


O resultado mostrado na tela será: 


6 
20 
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Observe que o operador ++ tem prioridade mais alta que os operadores + e *, por 
isso a primeira operação realizada pelo PHP foi o incremento do valor da variável 
$num. O segundo operador de maior prioridade no exemplo apresentado é o de mul- 
tplicação, portanto a segunda operação realizada foi 3*2. Após essas duas operações, 
ficamos com a soma 8+6+6. Note que temos dois operadores iguais (de adição), 
portanto, como têm a mesma prioridade, a expressão é avaliada da esquerda para 
a direita: 8+6 = 14. E depois 14+6 = 20, que foi o resultado mostrado na tela. 


Analisando esse exemplo, você pode perceber a importância da precedência dos 
operadores. Muitas vezes o uso incorreto dessas informações causa a exibição de 
resultados errados na saída dos programas. 


Estruturas de controle em PHP 


São comandos comuns à maioria das linguagens de programação, e o uso deles é 
fundamental para realizar decisões lógicas, testar se determinada expressão é ver- 
dadeira e repetir um bloco de comandos por um certo número de vezes ou até que 
uma condição seja atingida. Veremos os seguintes comandos: 


= Comandos condicionais: if e switch. 
= Comandos de repetição: while, do.. while, for e foreach. 


Vamos ver então como utilizar cada um deles. 


if 


Comando que avalia uma expressão e, dependendo do resultado, executa-se um 
conjunto diferente de instruções. O comando if pode possuir como complemento 
o elseif e/ou o else. 


Observe a sintaxe do comando if: 


If Cexpl) 

{ blocol + 
elseif ( exp2) 

{ bloco? 3 
else 

{ bloco3 + 
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Podemos ler essa sintaxe da seguinte maneira: 
= se exp1 for verdadeira, execute blocol; 
* senão, se exp2 for verdadeira, execute blocoz; 
= senão execute bloco3. 


É importante lembrar que apenas um dos blocos será executado e, depois disso, 
a execução continuará após o comando if. 


Em português, if significa “se” e else, “senão” Dentro da construção do comando 
if, podem aparecer diversos elseif, cada um avaliando uma expressão. Quando a 
expressão avaliada pelo comando if resultar em valor verdadeiro (True), será exe- 
cutado o bloco de comandos definido logo a seguir, que aparece entre chaves ({}). 
Se não houver a delimitação do bloco por chaves, será executada apenas a primeira 
linha após o if. 


Após executar esse bloco de comandos, a execução do programa será desviada 
para o fim do comando if, e as demais expressões (contidas no elseif e no else) não 
serão avaliadas, pois o comando if escolhe apenas um entre vários conjuntos de 
instruções para execução. 


Se a condição avaliada no comando if for falsa (False), o bloco de comandos 
seguinte não será executado, e será testada a expressão contida no primeiro elseif 
(se houver). Se todas as expressões avaliadas (do if e do elseif) forem falsas, o bloco 
de comandos executado será aquele que vier após o else. 


É importante destacar que não é obrigatório o uso de elseif e else com o co- 
mando if. O if pode aparecer sozinho, simplesmente determinando se um bloco 
de instruções será executado ou não. Por exemplo: 


<?php 
if (Snota == 10) 
{ 
echo "Parabéns! <br>"; 
echo "Você tirou a nota máxima!" 
} 
?> 


Nesse exemplo, se o valor da variável $nota for igual a 10, será mostrada na tela 
a seguinte mensagem: 


Parabéns! 
Você tirou a nota máxima! 
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Se o valor da variável nota não for igual a 10, esse bloco de comandos simples- 
mente não será executado, e a execução do programa seguirá normalmente. Pode- 
ríamos acrescentar um else ao comando e imprimir outra mensagem caso o aluno 
não tirasse nota 10. 


switch 


O comando switch é similar if, pois ambos avaliam o valor de uma expressão para 
escolher qual bloco de instruções deve ser executado. Em algumas ocasiões, você tem 
uma mesma variável a ser testada com valores diferentes, e nesse caso é interessante 
utilizar o switch, que trabalha basicamente com o operador de igualdade, enquanto 
o if trabalha com qualquer tipo de operador. Veja a sintaxe do comando switch: 


switch (operador) 
1 
case valori: 
<«comandos> 
break; 
case valor2: 
<comandos> 
break; 


case valorN: 
<comandos> 
break; 

default: 
<comandos> 
break; 


} 


Perceba que, após cada bloco de comandos, se deve utilizar o break, para que o co- 
mando switch seja encerrado e a execução continue após ele. Se não utilizarmos o break, 
o PHP continuará a execução dentro do switch, avaliando as demais expressões. 


Veja a seguir um exemplo de uso desse comando: 


<?php 
switch ($numero) 
{ 
case 's!: 
echo "Você escolheu a opção SIM"; 
break; 
case 'n': 
echo " Você escolheu a opção NÃO "; 
break; 
default: 
echo " A opção digitada é inválida”; 
break; 
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A opção default tem a mesma função da opção else no comando if. Se todas as 
expressões anteriores retornarem falso, será executado o bloco de comandos que 
aparecer após o default. O uso do default não é obrigatório no comando switch. 


while 


Traduzindo para o português, while significa enquanto. O comando while é composto 
por uma expressão e por um bloco de comandos. O comando avalia a expressão, 
e enquanto essa expressão retornar o valor verdadeiro, a execução do bloco de 
comandos em questão será repetida. Quando o valor retornado é falso, encerra-se 
o laço de repetição (loop) e a execução é transferida para o fim do comando while. 
Assim como no comando if, devemos utilizar chaves como delimitadores sempre 
que o bloco possuir mais de uma instrução para executar. 


Veja a sintaxe do comando: 


while (exp) 
{ 


comandos 


Devemos tomar cuidado para não colocar no comando while expressões que 
jamais se tornarão falsas, senão teremos um loop infinito, pois o PHP repetirá para 
sempre o bloco de instruções. Veja a seguir um exemplo de utilização do while: 


prog13.php 


<?php 
$cont = 1; 
while ($cont < 100) 
{ 


echo "O valor atual do contador é $cont <br>"; 
$cont++; 


?> 

A execução desse programa resultará em 99 linhas mostradas na tela: 
O valor atual do contador é 1 

O valor atual do contador é 2 

O valor atual do contador é 3 


O valor atual do contador é 99 


Quando a variável $cont atingir o valor 100, a expressão retornará o valor falso, 
pois 100 não é menor que o próprio 100, e isso fará que o loop seja encerrado. 
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do...while 


A diferença entre o while e o do. . .uhile é que o while avalia a expressão no início do 
laço e o do.. while avalia a expressão no final do laço. Portanto, utilizando do.. .while, 
o laço será executado pelo menos uma vez, e utilizando somente while, o laço pode 
não ser executado, caso a expressão avaliada retorne falso na primeira avaliação. A 
sintaxe do comando é a seguinte: 


do 


comandos 
} while (exp); 


Veja a seguir um exemplo: 


& progi4.php 


<?php 
$numero = 1; 
do 
{ 


echo "O valor atual de número é $numero <br>"; 
$numero++; 
} while ($numero < 4); 
?> 


O resultado gerado pela execução desse programa será: 


O valor atual de número é 1 
O valor atual de número é 2 
O valor atual de número é 3 


for 


Utilizamos o comando for quando queremos executar um conjunto de instruções um 
dado número de vezes. É um comando muito útil que pode ser usado, por exemplo, 
para imprimir todos os elementos de um array ou todos os registros retornados de 
uma consulta a um banco de dados. 


A sintaxe do comando for é a seguinte: 


for ( inicialização; condição; operador ) 
{ 


comandos 
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Como inicialização, geralmente determinamos o valor inicial da variável que 
controlará o loop. O parâmetro de inicialização poderá ser $cont=0. No segundo pa- 
râmetro, devemos colocar a condição que deve ser atingida para que o laço continue. 
Se quiséssemos executar o loop 20 vezes, o valor do parâmetro de condição seria 
$cont<20. Quando essa condição retorna o valor falso, o loop é encerrado. O último 
parâmetro geralmente é usado para atualizar o valor da variável de controle do loop, 
fazendo um incremento ou um decremento (por exemplo, $cont++). Ao final de cada 
interação do loop, o valor da variável de controle é atualizado automaticamente, 
dependendo do terceiro parâmetro que você definiu quando utilizou o comando 
for. Veja um exemplo de utilização do comando: 


prog15.php 
<?php 


for ($cont = 0; $cont < 10: $cont++) 


{ 
echo "A variável \$cont vale $cont"; 
echo "<br>": 
?> 


O resultado gerado pela execução desse programa será o seguinte: 


A variável $cont vale 0 
A variável $cont vale 1 


A variável $cont vale 9 


foreach 


O comando foreach nos oferece uma maneira mais fácil de “navegar” entre os ele- 
mentos de um array. Observe as duas sintaxes possíveis: 


foreach ($nome array as $elemento) 
{ 


comandos 


ou 


foreach ($nome_array as $chave => $valor) 


{ 


comandos 
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A primeira forma vai do primeiro ao último índice do array definido na variável 
$nome array, e a cada interação o valor do elemento corrente do array é atribuído à 
variável $elemento e o ponteiro interno do array é avançado. Dessa forma, podemos 
trabalhar com todos os valores do array utilizando apenas a variável $elemento. 


A segunda forma segue o mesmo critério, mas com uma diferença: além de o valor 
do elemento corrente do array ser atribuído à variável $elemento, a chave (ou índice) 
do elemento atual é atribuído à variável Schave. Acompanhe o exemplo a seguir: 


prog16.php 


<?php 
$vetor = array (1, 2, 3, 4); 
foreach ($vetor as $v) 


{ 


print "O valor atual do vetor é $v. <br>"; 


} 
$a = array ( "um" => 1, "dois" => 2, "tres" => 3 ); 
foreach ($a as $chave => $valor) 


{ 
print "\$a[$chave] => $valor.<br>"; 


} 


?> 


O programa apresentado mostrará na tela todos os valores do array $vetor e, 
depois, todas as chaves e valores do array $a. O segundo foreach desse exemplo 
mostrará o seguinte: 


$a [um] => 1. 
$a [dois] => 2. 
$a [tres] => 3. 


Integração com bancos de dados 


O PHP suporta diversos SGBDs (Sistemas de Gerência de Bancos de Dados), ofere- 
cendo um conjunto de funções para executar operações (consultas, inclusões, alte- 
rações, exclusões etc.) sobre cada um deles. Entre eles, temos: MySQL, PostgreSQL, 
SQLite, InterBase, Oracle, SQL Server, Sybase, entre outros que oferecem suporte à 
linguagem SQL (Structured Query Language). Os bancos de dados não suportados 
diretamente pelo PHP podem ser acessados via ODBC. Os comandos existentes 
para cada um dos SGBDs estão disponíveis na documentação do PHP, que pode 
ser obtida no site oficial (http://www. php.net). 
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Este livro não tem o objetivo de ensinar a linguagem SQL nem de mostrar como 
instalar um determinado sistema de banco de dados. Neste tópico, faremos apenas 
uma rápida revisão de como utilizar o PHP para acessar e realizar consultas sobre 
o MySQL (http: //wmy.mysql.com), que é um dos SGBDs mais utilizados com o PHP. 
Essa revisão será importante, visto que alguns exemplos que serão apresentados 
neste livro necessitam de acesso ao banco de dados. 


Mais adiante, no Capítulo 10, você irá aprender outra forma de realizar operações 
sobre um banco de dados. Nele serão apresentadas bibliotecas de abstração, que 
visam a oferecer um conjunto de comandos único para acessar diferentes SGBDs. 


Vamos ver então as principais funções para operar sobre o MySQL. Antes de 
acessar um banco de dados e começar a realizar operações sobre ele, precisamos 
estabelecer uma conexão com o servidor MySQL. Para isso, utilizaremos a função 
de conexão mysql_connect, que possui a seguinte sintaxe: 


recurso mysql connect ([string servidor [, string usuário [, string senha 
[, bool novo link [, int flags cliente 1111) 


Parâmetro Descrição 

servidor Endereço do servidor no qual está localizado o banco de dados. 
usuário Nome de usuário a ser utilizado para a abertura da conexão. 
senha Senha a ser utilizada para a abertura da conexão. 

novo. link Indica se deve ser aberto um novo link quando for feita mais de 


uma chamada a essa função com os mesmos parâmetros. 


flags cliente Define algumas configurações do cliente. Pode ser uma combinação 
das constantes MYSQL CLIENT COMPRESS, MYSQL CLIENT IGNORE SPACE e 
MYSQL CLIENT INTERACTIVE. 


Em caso de sucesso, essa função retorna o identificador da conexão, que poste- 
riormente será passado como parâmetro para a função de fechamento desta. Em 
caso de falha, retorna FALSE. Para fazer, por exemplo, a conexão com um banco de 
dados chamado bdteste, que possui como nome de usuário juliano e como senha 
teste, podemos executar o seguinte comando: 


$conexao = mysql_connect (“Tocalhost", "juliano", “teste"); 


Se o banco de dados estiver localizado em um servidor diferente, bastará subs- 
tituir localhost pelo nome ou endereço IP desse servidor. Após abrir a conexão, o 
próximo passo é selecionar, por meio do comando mysql. select db, qual será o banco 
de dados utilizado. Por exemplo: 


mysql select db ("bdteste'); 
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A partir daí, já podemos realizar operações sobre o banco de dados. A função 
PHP responsável por executar comandos SQL é a mysql. query, que possui a seguinte 
sintaxe: 


recurso mysql. query (string comando [, recurso id conexão]) 


Parâmetro Descrição 


comando Comando SQL a ser executado. 


id conexão Pode ser usado caso exista mais de uma conexão aberta; deve conter 
o identificador da conexão na qual o comando deve ser executado. 


No caso da execução de comandos SELECT, a função mysql. query irá retornar um 
conjunto de resultados (se houver). Existem várias formas de obter os valores desses 
resultados, utilizando funções como mysql. result, mysql fetch row, mysql fetch assoc € 
nysql.fetch array. Após realizar todas as operações necessárias, devemos encerrar a 
conexão com o banco de dados executando a função mysql. close. 


Vamos ver rapidamente um exemplo de programa PHP que realiza todos os 
passos descritos nesse tópico. Antes de criar o programa, vamos criar uma tabela 
no MySQL, na qual ficarão armazenados os dados. Essa tabela, que irá armazenar 
informações sobre livros, será criada da seguinte forma no utilitário mysql: 


create table livros 


( 
isbn varchar(13), 
titulo varchar(80) NOT NULL, 
autor varchar(80) NOT NULL, 
paginas smallint NOT NULL, 
preco float NOT NULL 

); 


O programa PHP deverá abrir uma conexão com o servidor MySQL, selecio- 
nar todos os nomes de livros e seus respectivos autores e, logo após, exibir essas 
informações na tela, uma em cada linha. Acompanhe, então, o código do programa 
prog17.php apresentado a seguir: 


£ prog17.php 


<?php 

$servidor = "localhost"; 

$usuario = "juliano"; 

$senha = "12345"; 

$banco = "test"; 

$con = mysql_connect($servidor, $usuario, $senha); 
mysql_select_db ($banco}; 
$res = mysql_query("SELECT titulo,autor FROM livros"); 
$num_linhas = mysql num rows(S$res); 
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for ($i = 0; $i < $num linhas; $i++) 


{ 
$dados = mysql_fetch_row ($res); 
$titulo = $dados[0]; 
$autor = $dados[1]; 
echo "$titulo - $autor <br>"; 
} 
mysql_close($con}; 


?> 


Veja que para percorrer o resultado com o comando for, utilizou-se antes a função 
mysql num rows, que retorna o número de linhas resultantes em uma consulta SQL. 
Ao executar esse programa no navegador, será exibido, para cada um dos livros, seu 
título e, ao lado, o nome do autor. 


Importante: se sua versão do MySQL for 4.1 ou superior, para aproveitar todos 
seus recursos, você deverá usar os comandos da biblioteca “mysqli” (Improved 
MySQL). Por exemplo: 


* em vez de mysql_connect, use a função mysqli. comect; 


"= em vez de mysql_query, use a função mysqli query; 


e assim por diante. No site da Novatec Editora, o exemplo anterior está disponível 
também na versão da biblioteca “mysqli” 


Capítulo 2 


Melhorando o processamento de formulários 


Neste capítulo você irá aprender a tornar seu site muito mais interativo, com a 
utilização de formulários, além de saber como dar um tratamento adequado às 
informações submetidas pelo usuário. Serão apresentadas diversas validações que 
podem ser aplicadas tanto no lado do cliente, com JavaScript, como no lado do 
servidor, com PHP Além disso, serão mostradas algumas funções para formatação 
dos dados recebidos de um formulário. 


Criação do formulário 


Se você está lendo este livro de PHP, provavelmente deve ter conhecimento da lingua- 
gem HTML e da criação de formulários utilizando essa linguagem. Um formulário é 
composto de, no mínimo, um campo para entrada de dados e um botão para enviar 
as informações contidas nele. Veja na figura 2.1 um exemplo de formulário. 


O código HTML para esse formulário é o seguinte: 


<form> 
<p> 
<b>Digite seu e-mail: <input type="text” name="email” size="20"></b> 
<input type="submit" value="Enviar!" name="enviar"> 
</p> 
</form> 


Se você clicar o botão Enviar! desse formulário, o valor que foi preenchido no campo 
de e-mail não será enviado a lugar algum, pois seu navegador não sabe para onde en- 
viar as informações. Portanto, o formulário definido anteriormente não tem nenhuma 
utilidade, pois perdemos as informações quando clicamos o botão Enviar!. 
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[http /HocalhostHormiulari 
Editar Exibir 


Favoritos  Fesament 


êsrquivo 


| Links | 


EJ Concuido TE 


CC E Inranetloca 


i 


Figura 2.1 — Exemplo de formulário. 


Para tornar esse formulário útil, devemos informar ao navegador para onde devem 
ser enviadas as informações. Você utilizará os formulários para enviar dados a seus 
programas PHP, então o correto é informar ao navegador qual programa receberá 
esses dados. Isso é feito com a opção action, utilizada na tag form do HTML. Veja o 
exemplo a seguir: 

<form action="recebe dados. php"> 

<p><b>Digite seu e-mail: <input type="text” name="email" size="20"></b> 
<input type="submit" value="Enviar!" name="enviar"> 


</p> 
</form> 


Agora, quando você clicar o botão Enviar!, o conteúdo do campo e-mail será 
enviado ao programa recebe dados. php e esse programa tratará a informação recebi- 
da. Só falta você criar o programa especificado e, nele, fazer o processamento das 
informações de acordo com suas necessidades. 


Observe que para definir um campo de entrada de dados utilizamos a tag input 
da HTML. Essa tag pode vir acompanhada de diversas opções. Vamos ver as prin- 


cipais: 

Opção Descrição 

name Informa qual é o nome do campo. i o 

value Informa um valor-padrão para o campo. 

size Informa o tamanho do campo exibido na tela. 

maxtength Informa o número máximo de caracteres que pode ser digitado no 
campo. 

type Informa qual é o tipo do campo de entrada de dados. 


Os valores possíveis para a opção type da tag input são mostrados na tabela a 
seguir: 
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Valor Descrição 


text Mostra uma caixa de texto de uma linha e permite a entrada de valores 
numéricos ou alfanuméricos. 

password Utilizado para a digitação de senhas. São mostrados asteriscos (*) no lugar 
dos caracteres digitados, mas a informação é enviada normalmente. 

hidden É um campo escondido que não aparece na tela. Podemos usá-lo para 
passar informações aos programas que recebem os dados. Veremos 
mais adiante que esses campos são de grande utilidade. 


select Mostra uma lista de seleção (também conhecida como drop-down). 

checkbox Exibe uma caixa de seleção, que pode ser marcada ou desmarcada. 

radio São botões de seleção, em que o usuário escolhe uma entre várias 
opções disponíveis. 

textarea Caixa de texto com várias linhas. 

file Permite o envio de arquivos. 

submit Botão que aciona o envio dos dados do formulário. 

image Tem a mesma função que o submit, mas utiliza uma imagem em vez do 
botão tradicional do formulário. 

reset Limpa todos os campos de um fomulário e retorna ao valor-padrão (se 
existir). 


Veja um exemplo de formulário que utiliza diversos tipos de campos: 


Æ http:/ /ocalhost/formuil 


| Arquivo Editar Exibir Favoritos Ferramentas Ajuda 


| Endereço http: localhost forrmulariosfForrmularioZ html 


lo que você achou do site? 


6 Muito Eom C Bom C Regular C Um Lizo 
Qual a seção que você mais gostou? [Galeria de Fotos » 
Digite seus comentários no espaço abaixo: 
Diga-nos como entrar em contato com você: 
Home j 
E-mail 
Fone | 
FAX] 
T Quero receber as novidades do site por e-mail 
Enviar Dados Limpar Formulário 
(E condado UT O OO agitant beal O g 


Figura 2.2 — Formulário com diversos tipos de campos. 
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O código HTML para esse formulário é o seguinte: 


<form action="processa. dados. php"> 
<p>0 que você achou do site?<br> 
<input type="radio" name="avaliacao” value="muitobom” checked>Muito Bom 
<input type="radio" name="avaliacao” value="bom">Bom 
<input type="radio" name="avaliacao" value="regular">Regular 
<input type="radio" name="avaliacao” value="umlixo">Um Lixo 
</p> 
<p> 
Qual a seção que você mais gostou? 
<select name="secao" size="1"> 
<option value="emcartaz">Em Cartaz</option> 
<option value="trilhasonora">Trilha Sonora</option> 
<option value="fotos">Galeria de Fotos</option> 
<option value="bilheteria">Bilhetéria</option> 
<option value="outra">Outra</option> 
</select> 
</p> 
<p>Digite seus comentários no espaço abaixo:<br> 
<textarea name="Comentarios" rows="5" cols="42"></textarea> 
</p> 
<p>Diga-nos como entrar em contato com você: <br> 
Nome <input type="text" size="35" maxlength="256" name="nome"><br> 
E-mail <input type="text" size="35" maxlength="256" name="emai]l"><br> 
Fone <input type="text" size="35" maxlength="256" name="fone"><br> 
FAX <input type="text" size="35" maxlength="256" name=" fax"><br> 
</p> 
<input type="checkbox" name="novidades" value="nov"> 
Quero receber as novidades do site por e-mail 
<p> 
<input type="submit" value="Enviar Dados"> 
<input type="reset" value="Limpar Formulário"> </p> 
</form> 


Enviando as informações para um programa PHP 


Vimos no tópico anterior que para especificar qual programa PHP receberá os dados 
do formulário, utilizamos a opção action da tag form do HTML. Exemplo: 


<form action="processa_dados . php"> 


Resta saber como esses dados serão passados ao programa PHP. Existem dois 
métodos de passagem de parâmetros: GET e POST. No caso de um formulário, o tipo 
de método a ser utilizado é especificado na opção method da tag form. Exemplo: 


<form action="processa dados. php4" method="POST"> 


Veremos em detalhes cada um deles para que você entenda a diferença. 
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Método GET 


Esse é o método-padrão para o envio de dados. Se no momento da criação de um 
formulário nenhum método for especificado na opção method da tag form, estaremos 
utilizando o método CET para o envio dos dados. 


Nesse método, os dados serão enviados com o nome da página que processará 
os dados recebidos. Considere o seguinte formulário como exemplo: 


<form action="processa dados. php"> 
<p>Digite seu nome: <input type="text” name="nome” size="30"></p> 
<p>Digite sua idade: <input type="text” name="idade” size="3"></p> 
<p><input type="submit" value="Enviar!" name="enviar"></p> 

</form> 


Note que esse formulário não mostra a opção method, portanto o padrão é adotado 
(method="GET"). Suponha que o campo nome seja preenchido com o valor Joaquim 
e o campo idade, com o valor 20. Logo após clicarmos o botão Enviar!, o endereço 
ativado será o seguinte: 


http://www. seusite.com.br/processa dados. php?nome=Joaquiméi dade=20 


Os campos do formulário serão passados como parâmetros após o endereço de 
destino. O caractere ? representa o início de uma cadeia de variáveis e o símbolo & 
identifica o início de uma nova variável. As variáveis e seus respectivos valores são 
separados pelo caractere =. 


Existem alguns inconvenientes ao utilizar o método GET. Primeiramente, há um 
limite de caracteres que podem ser enviados (em torno de 2.000 caracteres). Outro 
problema é que o usuário enxergará todos os parâmetros na barra de endereço do 
navegador, o que não é muito agradável. 


Para resolver esses problemas, existe o método POST. Em compensação, o método 
GET possui uma grande vantagem: além de enviar informações via formulários, pode 
ser utilizado também para a passagem de parâmetros por meio de links. Imagine, 
por exemplo, uma loja virtual, onde há um link para cada produto. Certamente cada 
link passa como parâmetro um número identificador do produto, para ser tratado 
por determinado programa. 


O link para um produto específico poderia ser o seguinte: 
http://www. lojinhadojoao. com.br/exibe. produto. php?id. produto=50 


Dessa forma, um programa chamado exibe produto.php receberia o número 
identificador do produto e realizaria uma consulta ao banco de dados para buscar 
informações detalhadas, como descrição, preço etc. Podemos, se necessário, passar 
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mais de um parâmetro através do método GET. Para isso, basta utilizar o símbolo & 
fazendo a separação. 


Por exemplo, o link para consulta de uma subcategoria da loja pode ser o se- 
guinte: 


http://www. lojinhadojoao.com.br/lista produtos. php?categoria=2&subcategoria=5 


Somente com o método GET podemos passar parâmetros por links. O método 
POST trabalha somente com formulários. 


Método POST 


Para utilizar o método Post, devemos utilizar opção method da tag form para informar 
ao navegador. Exemplo: l 


<form action="processa dados. php" method="POST"> 
<p>Digite seu nome: <input type="text” name="nome" size="30"></p> 
<p>Digite sua idade: <input type="text” name="idade” size="3"></p> 
<p><input type="submit" value="Enviar!” name="enviar"></p> 

</form> 


Ao contrário do método GET, que envia os dados por uma cadeia de variáveis 
após o endereço-destino, o método POST envia os dados do formulário no próprio 
corpo da mensagem encaminhada ao servidor. 


Como os dados são enviados no corpo da mensagem, quando o usuário clicar o 
botão Enviar!, ele não verá em sua barra de endereços aquele endereço enorme con- 
tendo uma cadeia de variáveis. Ele verá apenas o endereço do programa ativado: 


http://www. seusite.com.br/processa dados. php 


Outra grande vantagem do método POST é que não há limitação de tamanho dos 
dados que estão sendo enviados, ao contrário do GET, que envia os dados por uma 
cadeia de variáveis de tamanho limitado. Portanto, recomenda-se utilizar o método 
POST para formulários que possuem muitas informações a ser enviadas. O método 
GET pode ser usado em formulários mais simples, que possuem poucos campos. 


Por meio do método POST, podemos enviar outros tipos de dados que não podem 
ser enviados pelo método GET, como, por exemplo, imagens ou outros arquivos (para 
isso, utilizamos o valor file na opção type da tag input do HTML). 
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Os arrays superglobais $_GET e $_POST 


Depois de especificado qual o programa PHP que receberá os dados (na opção action 
da tag form), é preciso saber como tratá-los dentro do programa. Para isso, o PHP nos 
disponibiliza dois arrays superglobais, sendo um para acessar os dados enviados 
pelo método GET e outro para os dados enviados pelo método Post. São eles: 


= $ CET 
= $_POST 


Em versões mais antigas do PHP, esses arrays eram chamados de $HTTP.GET. VARS e 
SHTTP. POST. VARS. Utilizando os arrays superglobais, os nomes dos campos do formu- 
lário serão usados como chave associativa para acessar seus valores. Se usassemos, 
por exemplo, o método POST para enviar um formulário com os campos nome e email, 
dentro do programa PHP acessaríamos esses dados da seguinte maneira: 


$ POSTI"nome"] 
$_POST["emai]"] 


Se o método utilizado fosse o GET, usaríamos: 


$_GET["nome"] 
$_GET["email"] 


Há ainda uma outra alternativa para acessar os dados recebidos de um formulá- 
rio, sem utilizar os arrays $.GET e $_POST. No arquivo de configuração php.ini, há uma 
diretiva chamada register_globals, que se for habilitada (valor on), permitirá que os 
dados sejam acessados como variáveis, colocando o símbolo $ seguido do próprio 
nome do campo definido no formulário. Por exemplo, o campo nome do formulário 
poderia ser referenciado dentro do programa PHP pela variável $nome. 


Por questões de segurança, desde a versão 4.20 do PHP a register_globals foi 
desabilitada. Se você habilitá-la, tome cuidado para não criar dentro do programa 
outras variáveis com o mesmo nome dos campos do formulário, pois isso fará que 
o conteúdo do campo seja sobrescrito. 


Funções especiais para formatação de dados 


Algumas providências devem ser tomadas quando um programa recebe um conjun- 
to de dados. Imagine que você vai desenvolver um fórum de discussão. Um fórum 
é um local onde todos os usuários podem colocar mensagens para debater sobre 
determinado assunto. 
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Então você desenvolve um programa que recebe as informações de um formu- 
lário e as grava em um banco de dados ou em simples arquivos em formato texto. 
Terminado esse programa, você coloca seu fórum para funcionar na internet. No dia 
seguinte, você diz: “Vou lá ver se os usuários estão colocando mensagens em meu 
fórum!” Você entra em seu site, acessa o fórum e encontra uma foto pornô colocada 
em uma das mensagens. Isso ocorreu porque um usuário, ao escrever uma mensagem, 
digitou um comando HTML que exibe uma imagem existente em outro site. 


Ele poderia, por exemplo, ter digitado: 
<img src="http: //vuw. siteporno.com.br/fotol.jpg"> 


Como nenhuma precaução foi tomada, os usuários poderiam utilizar qualquer 
comando HTML no meio de suas mensagens, e isso possivelmente faria que con- 
teúdos não desejados fossem acrescentados a seu site. 


A solução para esse problema é utilizar uma função do PHP para transformar 
os comandos HTML, fazendo que estes sejam exibidos na tela como texto comum. 
Essa função é a htmlspecialchars, cuja sintaxe é a seguinte: 


string htmlspecialchars (string string [, int estilo aspas [, string conj caracterel!) 


Parâmetro Descrição 
string Texto sobre o qual a formatação será aplicada. 
estilo aspas Define como devem ser tratadas as aspas simples e duplas. O modo 


padrão é ENT COMPAT, que converte apenas as aspas duplas. Se for 
especificado o valor ENT-QUOTES, ambas serão convertidas e, se for 
utilizado o ENT. NOQUOTES, nenhuma das duas será convertida. 


conj caractere Define o conjunto de caracteres a ser usado na conversão. O padrão 
é ISO-8859-1. 


Essa função retira as tags HTML e coloca caracteres especiais em seus lugares. 
As mudanças feitas serão as seguintes: 


Caractere Descrição 


& É substituído por &amp. 
“ É substituído por &quot; (se ENT NOQUOTES não estiver definido). 
: É substituído por 84039; (se ENT.QUOTES estiver definido). 

É substituído por &lt;. 


> É substituído por &gt;. 


Ao aplicarmos a função htmlspecialchars sobre uma string e exibi-la na tela, vere- 
mos apenas os comandos HTML digitados, e não os resultados gerados por esses 
comandos, pois a função transformou as tags em caracteres especiais que foram 
reconhecidos pelo navegador. Acompanhe o exemplo a seguir: 
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caracteres especiais.php 


<?php 
$texto = "<img src=http://wuw.niederauer.com.br/figuras/interbase.Jpg>": 
$novo texto =htmIspecialchars($texto); 
echo $texto . "<br>"; 
echo $novo texto; 
?> 


A variável $texto desse programa contém o valor original (digitado por um usu- 
ário, por exemplo) da string e a variável $novo. texto contém o valor da variável Stexto 
após a aplicação da função htmlspecialchars. A execução desse programa mostra duas 
linhas na tela: a primeira linha mostrará a imagem interbase.jpg, que é obtida de 
outro servidor, e a segunda linha, o valor da string em formato texto: 


<img src=http://vumw.niederauer.com.br/figuras/interbase. jpg> 


Isso ocorreu porque a função htmlspecialchars transformou os caracteres > e < em 
&gt; e&lt;. O navegador leu esses códigos e apresentou na tela novamente os símbolos 
> e <, mas não os executou como se fossem parte do código HTML. 


Outra precaução a ser tomada no momento de receber os dados é a utilização de 
dados que contêm caracteres especiais. Se, por exemplo, o usuário digitar no campo 
nome do formulário a seguinte informação: 


João da Silva, vulgo "João da Maloca” 
O valor recebido pelo programa PHP será: 


João da Silva, vulgo N"João da Maloca" 


O PHP coloca o caractere de controle  antecedendo caracteres especiais para 
evitar um erro na leitura das variáveis. Existe uma função que, aplicada a uma 
string, retira seus caracteres de controle. Essa função é a stripslashes, cuja sintaxe 
é a seguinte: 


string stripslashes (string string) 

Por exemplo, ao aplicar essa função sobre uma string: 
\" é substituído por " 

V é substituído por ' 


e assim por diante. Duas barras invertidas seguidas (W) são substituídas por 
apenas uma (). 
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Quando utilizamos o método GET, outras funções que podem ser usadas no 
tratamento dos dados recebidos são a urldecode e a urlencode. 


string urlencode (string string) 
string urldecode (string string) 


Essas funções são úteis porque todos os caracteres que não são alfanuméricos 


(com exceção do sublinhado “ ?) são convertidos para um código hexadecimal 
antecedido pelo símbolo %. Por exemplo: passando o nome “Joaquim de Souza” 


pelo método GET, teremos a seguinte URL: 


http://www. seusite.com.br/processa dados. php?nome=Joaquim20dew20Souza 


Então, dentro do programa processa dados. php deveríamos ter a seguinte linha: 


$nome = urldecode ($nome); 


Aplicando a função urldecode sobre a variável $nome, os códigos hexadecimais 
serão substituídos pelos caracteres os quais representam. Já a função urlencode 
faz O processo contrário, transformando os caracteres não-alfanuméricos em seus 
respectivos códigos. Se a variável $nome possuísse o valor “Joaquim de Souza” após 
a aplicação da função urlencode teríamos o valor Joaquimt20dex20Souza. Essa função é 
útil quando queremos redirecionar esses dados para outro programa PHP por meio 
do método CET. 


Validação no cliente com JavaScript 


Veremos no próximo tópico como aplicar diversas validações de dados em um 
programa PHP. Porém, agora veremos como aplicar validações no lado do cliente, 
ou seja, antes que os dados do formulário sejam enviados à página PHP. 


Esse tipo de validação, normalmente feita com a linguagem de script JavaScript, 
tem suas vantagens e desvantagens. À vantagem é que, caso o usuário não tenha 
preenchido corretamente todos os campos do formulário, poderemos economizar 
tempo de diversas formas, tais como: 


* reduzir o tempo de espera do usuário por uma resposta do servidor; 
«= validar os dados sem transferi-los através da rede; 


* utilizar o processador da máquina do usuário em vez de desperdiçar os re- 
cursos de processamento do servidor. 
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A desvantagem da validação no lado cliente é que o código JavaScript aparece no 
meio do código HTML e, por isso, pode ser visto por qualquer usuário. Dessa forma, 
qualquer um que queira burlar seu sistema de cadastro poderá copiar o código-fonte 
da página e remover a função JavaScript que aplica a validação de dados. 


Então, qual é a solução? Devemos usar validação no cliente ou no servidor? À 
resposta é: em ambos os casos! Assim, seu sistema ficará muito mais consistente, 
pois além de economizar tempo aplicando a validação direto na máquina do usuário, 
caso alguém tente burlar o sistema, ainda haverá a validação no lado do servidor 
para garantir a segurança. 


O objetivo deste livro não é ensinar como programar com a linguagem JavaScript, 
portanto veremos apenas como utilizar essa linguagem para criar uma função de 
validação para os dados recebidos de um formulário HTML. Essa função deverá 
ser incluída na mesma página do formulário e irá possuir a seguinte estrutura: 


<script language="javascript”> 
function valida (nomeform) 


{ 
} 


</script> 


A idéia é testar campo a campo do formulário, retornando verdadeiro (true) 
caso todos os campos tenham sido preenchidos corretamente e falso (false) caso 
algum campo esteja preenchido de forma incorreta. A chamada para a função valida 
deverá ser incluída na própria tag do formulário (<form>), utilizando a propriedade 
onSubmit. Por exemplo: 


<form method="POST" action="processa dados.php" onSubmit="return valida(this)"> 


Dessa forma, quando o usuário clicar o botão de envio do formulário, a função 
JavaScript será ativada e, caso retornar true, os dados serão enviados ao servidor. 
Caso contrário, o navegador irá exibir imediatamente uma mensagem (alerta) ao 
usuário informando qual campo está preenchido incorretamente, para que ele 
possa corrigi-lo. 


Vejamos alguns exemplos de validações que podem ser feitas dentro dessa fun- 
ção. Para verificar se um determinado campo não foi deixado em branco, faremos 
o seguinte teste: 


if (nomeform.nomecampo. value == ""9 
alert ("Por favor digite o nome."9; 
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Para testar se um determinado caractere existe dentro de uma string, podemos 
utilizar a propriedade index0f. Essa verificação é bastante útil para testar campos de 
e-mail, para checar se o usuário digitou os caracteres requeridos. Por exemplo, para 
testar se ele digitou o caractere @ (arroba), temos: 


if (nomeform.email.value. index0f('a", 0) == -1) 
alert ("E-mail inválido.'); 


É possível testar também se o usuário digitou o número mínimo de caracteres 
para um determinado campo. Por exemplo, se tivéssemos um campo chamado cep 
e quiséssemos verificar se foram digitados os oito dígitos, usaríamos a propriedade 
length do campo: 


if (nomeform.cep.value. length < 5) 
alert ("O CEP deve possuir 8 dígitos!'): 


Unindo essas três consistências na função JavaScript valida, teríamos o código apre- 
sentado a seguir, que deve ser incluído na página HTML que contém o formulário: 


<script Tanguage="javascript"> 
function valida (nomeform) 


{ 
if (nomeform.nomecampo.value == "") 
{ alert ("Por favor digite o nome."); return false; } 
if (nomeform,email.value.index0f('a!, 0) == -1) 
{ alert ("E-mail inválido."); return false: } 
if (nomeform.cep.value. length < 5) l 
{ alert ("O CEP deve possuir 8 dígitos!"); return false; } 
return true; 
} 
</script> 


Observe que quando um campo possui valor inválido, é retornado o valor false 
ao formulário. Esse valor indica que o formulário não deve ser submetido ao servi- 
dor. Ao final deste capítulo, veremos um exemplo completo de validação de dados, 
tanto no lado cliente como no lado servidor. 


Validação no servidor com PHP 


Conforme se comentou no tópico anterior, mesmo que você realize a validação no 
lado cliente com JavaScript, é fundamental realizar também a validação no lado do 
servidor com o PHP, pois alguns usuários podem burlar a lógica do lado cliente. 


A seguir, serão apresentados alguns tipos de validação que podemos aplicar no 
PHP sobre os campos recebidos de um formulário HTML. 
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Espaços em branco 


Muitas vezes devemos evitar que o usuário digite espaços em branco em alguns 
campos, como, por exemplo, em campos de e-mail, username e senha. Uma alter- 
nativa é usar a função strstr do PHP, que procura a primeira ocorrência de uma 
string dentro de outra. 


Sua sintaxe é a seguinte: 


string strstr (string string, string buscar) 


Parâmetro Descrição 
string String sobre a qual a busca será feita. 
buscar Texto a ser buscado dentro da string. 


Caso o texto seja encontrado, a função strstr retorna a substring que se inicia 
na primeira ocorrência desse texto. Caso contrário, a função retorna FALSE. Portanto, 
supondo que a senha esteja armazenada na variável $senha, podemos fazer o seguinte 
teste para verificar se esta contém espaços em branco: 


<?php 


if (strstr ($senha, ' ') != FALSE) 
echo "A senha não pode conter espaços em branco. "; 


?> 


Número mínimo de caracteres 


Verificar se o usuário digitou o número mínimo de caracteres requeridos para um 
campo é uma tarefa que pode ser executada pela função strlen do PHP, que retorna 
o número de caracteres existentes em uma string: 


int strlen (string str) 


Essa validação é aplicada a campos como CEP, CPF, CNPJ, username, senha, 
estado, entre outros, que requerem um tamanho mínimo. 


Por exemplo, para a sigla de um estado, devemos exigir que sejam digitados 
dois caracteres e, para uma senha, o ideal seria que esta tivesse, no mínimo, cinco 
caracteres para aumentar a segurança. Portanto, ao recebermos esses valores de um 
formulário HTML, poderíamos aplicar essas consistências da seguinte forma: 
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<?php 
if Cstrlen(Sestado) < 2) 
echo "O estado deve possuir 2 caracteres.”; 
elseif (strlen(Ssenha) < 5) 


echo "A senha deve possuir pelo menos 5 caracteres.”; 


?> 


Campos de e-mail 


Validar campos de e-mail normalmente requer a realização de diversos testes, visto 
que, além do tamanho mínimo, existem caracteres que são obrigatórios nesse tipo de 
campo. Uma alternativa interessante é eliminar os erros de digitação mais comuns 
do usuário antes de realizar o teste de validação. Isso pode ser feito por meio da 
função str replace, que busca por um determinado conjunto de caracteres dentro 
de uma string e os substitui por outro. 


Por exemplo, entre os erros mais comuns dos usuários, temos a digitação de: 
= espaços em branco; 

= barras (/); 

* ponto antes ou depois da arroba (.@ ou (O); 

« vírgula em vez de ponto; 

= ponto-e-vírgula em vez de ponto. 


Portanto, primeiramente se recomenda eliminar esses erros do campo de e-mail, 
para depois realizar o teste de validação. Supondo que o e-mail foi armazenado 
em uma variável chamada $email, poderíamos retirar esses erros da seguinte forma 
dentro do programa PHP: 


<?php 

Semail = str replace (" ", "", $email); 
$email = str replace ("/", "", $email); 
$email = str replace ("@.", “Q”, $email); 
$email = str replace (".@", "Q", $email); 
$email = str replace (",", ".”, $email); 
$email = str replace (";", ".", $email); 


?> 
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Note que o primeiro parâmetro da função str replace indica o conjunto de ca- 
racteres a ser substituído, enquanto o segundo define o conjunto de caracteres pelo 
qual a substituição será feita. Agora, sim, podemos realizar o teste de validação do 
campo, verificando se este possui o tamanho mínimo, se contém um caractere arroba 
(@) e pelo menos um ponto (). 


Para esse caso, existe uma função de grande utilidade chamada substr count, que 
retorna o número de ocorrências de um conjunto de caracteres dentro de uma string. 
A sintaxe dessa função é a seguinte: 


int substr count (string string, string substring) 


Parâmetro Descrição 
string String sobre a qual a busca será feita. 
substring Conjunto de caracteres cujas ocorrências serão contadas. 


Utilizando essa função e considerando um tamanho mínimo de oito caracteres 
para o e-mail, teremos, então, o seguinte comando condicional: 


<?php 


if (strlenC$email) < 8 || substr count(Semail, "@") [= 1 || 
substr count(Semail, ".") == 0) 
echo "O e-mail digitado é inválido! "; 


?> 


Note que não foi necessário verificar a ocorrência de espaços em branco, visto 
que foram eliminados anteriormente quando aplicamos a função str replace ao 
valor digitado pelo usuário. É claro que, em se tratando de campos de e-mail, você 
pode realizar validações mais complexas (por exemplo, com expressões regulares) 
do que as apresentadas neste tópico, embora as apresentadas aqui já lhe forneçam 
uma boa consistência. 


Numéricos 


Muitas vezes precisamos que em alguns campos sejam digitados apenas números, 
e não letras. Como exemplo, podem ser citados os campos de CEP, telefone, idade, 
quantidade, entre outros. Para testar se uma variável é numérica ou uma string 
contém apenas números, podemos utilizar a função is numeric, que possui a seguinte 
sintaxe: 


bool is_numeric (misto variável) 
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Por exemplo, para um campo de CEP, precisaríamos fazer duas consistências, 
sendo uma para verificar se o valor possui tamanho 8 e outra para garantir que as 
oito posições contenham apenas números. 


Veja no código a seguir como ficará a consistência para dois campos numéricos, 
CEP e idade: 


<?php 


if (strlen($cep) != 8 || !is numeric($cep)) 

echo "O CEP deve ser formado por 8 números. "; 
elseif (lis numeric($idade)) 

echo "A idade deve ser formada por números. ": 


?> 


CPF 


A maioria dos sites, principalmente os de comércio eletrônico, exige a digitação do 
número do CPF em seus cadastros. Para evitar que o usuário digite um número 
qualquer, é necessária a utilização de uma função de validação de CPF. 


Se você procurar na internet, irá encontrar diversas funções que realizam essa 
validação com base no dígito verificador do CPF. A seguir, será apresentada uma 
dessas funções, que você poderá aproveitar nos cadastros que criar em seu site: 


E valida cpf php 


<?php 
function cpf errado(Scpf) 
{ 


$erro = false; 
$aux_cpf = ""; 
for ($j = 0; $j < strlen($cpf); $j++) 
if (substr ($cpf,$j,1) >= "0" AND substr($cpf,$j,1) <= "9") 
$aux cpf .= substr($cpf,$j,1); 
if (strlen($aux_cpf) != 11) 
$erro = true; 
else 
{ 
$cpf1 = $aux_cpf; 
$cpf2 = substr($cpf,-2); 
$controle = “"; 
$start = 2; 
$end = 10; 
for ($i = 1; $i <= 2; $i++) 
{ 


soma = 0; 
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for ($j = $start; $j <= Send; $j++) 
$soma += substr(S$cpfl, ($j-$i-1),1) * (Send+1+$i-$5); 
if ($i == 2) 
$soma += $digito * 2; 
Sdigito = ($soma * 10) % 11; 
if ($digito == 10) 


$digito = 0: 
$controle .= $digito; 
$start = 3; 
$end = 11; 

k 
if C$controle != $cpf2) 
$erro = true; 


} 


return $erro; 
?> 


A função cpf errado retornará o valor true (verdadeiro), se o CPF estiver errado, 
e false (falso), se for digitado corretamente. Supondo que o número do CPF tenha 
sido armazenado na variável $cpf, um exemplo de chamada para essa função seria 
o seguinte: 


<?php 


if (cpf. errado($cpf)) 


{ 
echo “O CPF digitado é inválido"; 
exit; 

} 

?> 


Se o CPF digitado estiver incorreto, será executado o bloco de comandos definido 
pelo if, ou seja, será mostrada a mensagem “O CPF digitado é inválido” e a execução 
do programa será finalizada pelo comando exit. 


CNPJ 


Alguns sites aceitam também cadastros de pessoas jurídicas, exigindo a digitação 
do número do CNPJ da empresa. Para esses casos, é necessária uma tunção de 
validação de CNPJ, para evitar que o usuário digite um número qualquer. 


Assim como as funções que validam CPF se você procurar na internet, irá encon- 
trar diversas funções que realizam validação de CNPJ. A seguir, será apresentada uma 
dessas funções, que você poderá aproveitar nos cadastros que criar em seu site: 
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valida cnpj.php 


<?php 
function verificaCNPJ($cnpj) 
{ 
if (strlen($cnpj) <> 14) 
return 0; 
$sonal = ($cnpj[0] * 5) + 
(Senpj [1] * 4) + 
($cnpj [2] * 3) + 
(Scnpj[3] * 2) + 
(Scnpj[4] * 9) + 
($cnpj [5] * 8) + 
(Scnpj [6] * 7) + 
(Senpjl7] * 6) + 
(Scnpj [8] * 5) + 
(Senpj [9] * 4) + 
C$cnpj [10] * 3) + 
CSenpj [11] * 2); 


$resto = Ssomal % 11; 
$digitol = $resto < 2 ? 0 : 11 - $resto; 


$soma2 = ($cnpj[0] * 6) + 
($cnpj [1] * 5) + 
(Senpjl2] * 4) + 
($cnpj[3] * 3) + 
CScnpj [4] * 2) + 
C$cnpj[5] * 9) + 
($cnpj[6] * 8) + 
($cnpj[7] * 7) + 
($cnpj [8] * 6) + 
($cnpj[9] * 5) + 
($cnpj[10] * 4) + 
($cnpj[11] * 3) + 
CScnpj [12] * 2); 


$resto = $soma? % 11; 
$digito? = $resto< 2 ? 0 : 11 - $resto; 
return (($cnpj[12] == $digito1) && ($cnpj[13] == $digito2)); 


} 


?> 


A função verificaCNP] retornará o valor true (verdadeiro), se o número estiver correto, 


e false (falso), se estiver errado. É importante destacar que o CNPJ fornecido como 
parâmetro a essa função deve conter apenas números (sem pontos e barra). 


Supondo que o número do CNP] tenha sido armazenado na variável Scnpj, um 
exemplo de chamada para essa função seria o seguinte: 


<?php 
if (IverificaCNPJ(Scnpj)) 


{ 
echo “O CNPJ digitado é inválido"; 
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exit; 


?> 


Se o CNPJ digitado estiver incorreto, será executado o bloco de comandos defi- 
nido pelo if, ou seja, será mostrada a mensagem “O CNPJ digitado é inválido” e a 
execução do programa será finalizada pelo comando exit. 


Exemplo de validação de dados 


Veremos agora um exemplo de verificação dos campos de um formulário, tanto no 
lado do cliente como no lado do servidor. Suponha que temos um formulário com 
os campos nome, e-mail, estado, login, senha e confirmação da senha, conforme 
mostrado na figura 2.3. 


y «lota 
Í arquivo Editar Favoritos Ferramentas Ajuda E | 
) Endereço Í = httpr/flocalhostiformularios/cadast o,html j Ea lr Links 
Preencha o formulário para se cadastrar no site 
Nome | 
E-mail: | 
Estado | Escolha aqui + 
Logm 
Senha 
Confirme sua senha 
Enviar 
LEJ Concluido : Dodo do * d intranet local $ 
Figura 2.3 — Formulário a ser validado. 
Para apresentar esse exemplo, serão criadas duas páginas: 
Página Descrição 
cadastro. html É a página mostrada na figura 23. Irá conter o formulário HTML e 


a função JavaScript responsável pela validação dos campos no lado 
do cliente. 


cadastro. php Página PHP que irá receber os dados do formulário e realizar a 
validação no lado do servidor. 
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Na página cadastro .html, a função JavaScript de validação dos dados será nomeada 
como valida dados. Dentro dessa função será verificado: 


"= seo campo nome foi preenchido; 


= seo campo email foi preenchido e se contém os caracteres arroba (@) e ponto 


O; 
* se o usuário escolheu algum estado da lista de seleção; 


* se os campos login e senha possuem entre 5 e 15 caracteres. Também será testado 
se possuem espaços em branco; 


* sea senha ea confirmação da senha são iguais. 


Acompanhe, então, o código da página cadastro.html apresentado a seguir. Na 
seção do cabeçalho dessa página (entre as tags <head> e </head>) está definida a função 
JavaScript responsável pela validação dos campos do formulário. 


tes cadastro.html 


<html> 
<head> 
<title>Cadastro</title> 
<script language="javascript"> 
function valida dados (nomeform) 
{ 
if (nomeform.nome.value == "") { 
alert ("Por favor digite o nome.”); 
return false; 
} 
if (nomeform.email.value == || nomeform.email.value.index0f('a', 0) == -1 
|| nomeform.email.value.index0f('.', 0) == -1) { 
alert ("E-mail inválido. "); 
return false; 


} 

if (nomeform, estado. selectedIndex == 0) { 
alert ("Por favor selecione o estado."); 
return false; 


5 
if (nomeform. login.value. length < 5 || nomeform. login.value. length > 15) { 
alert ("O login deve conter entre 5 e 15 caracteres. "3; 
return false; 
5 
if (nomeform.Togin.value.index0f(' ', 0) != -1) { 
alert ("O Jogin não pode conter espaços em branco."); 
return false; 
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if (nomeform.senha.value. length < 5 || nomeform.senha.value. length > 15) { 
alert ("A senha deve conter entre 5 e 15 caracteres. "); 
return false; 
} 
if (nomeform.senha.value.index0f(' ', 0) != -1) { 
alert ("A senha não pode conter espaços em branco. "); 
return false; 
} 
1f (nomeform.senha.value != nomeform. confirmacao. value) { 
alert ("Senhas não conferem. Você digitou duas senhas diferentes."); 
return false; 
} 
return true; 
} 


</script> 


</head> 
<body> 
<h2>Preencha o formulário para se cadastrar no site</h2> 
<form method="POST" action="cadastro.php" onSubmit="return valida_dados(this)"> 
<p>Nome: <input type="text" name="nome” size="20"></p> 
<p>E-mail: <input type="text" name="email" size="20"></p> 
<p>Estado: 
<select size="1" name="estado"> 
<option>Escolha aqui</option> 
<option value="AC">AC</option> 
<option value="AL">AL</option> 
<option value="AM">AM</option> 
<option value="AP">AP</option> 
<option value="BA">BA</option> 
<option value="CE">CE</option> 
«option value="DF">DF</option> 
<option value="ES">ES</option> 
<option value="60">G0</option> 
<option value="MA">MA</option> 
<option value="MG">MG</option> 
<option value="MS">MS</option> 
<option value="MT">MT</option> 
<option value="PA">PA</option> 
<option value="PB">PB</option> 
<option value="PE">PE</option> 
<option value="PI">PI</option> 
<option value="PR">PR</option> 
<option value="RJ">RJ</option> 
<option value="RN">RN</option> 
<option value="RO">RO</option> 
<option value="RR">RR</option> 
<option value="RS">RS</option> 
<option value="SC">SC</option> 
<option value="SE">SE</option> 
<option value="SP">SP</option> 
<option value="TO">TO</option> 
</select> 
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</p> 

<p>Login: <input type="text" name="login" size="20"></p> 

<p>Senha: <input type="password" name="senha" size="20"></p> 

<p>Confirme sua senha: <input type="password" name="confirmacao" size="20"></p> 
<p><input type="submit" value="Enviar” name="enviar"></p> 

</form> 

</body> 

</html> 


Após o usuário preencher o formulário e clicar o botão Enviar, será ativada a 
função JavaScript valida dados, especificada no evento onSubmit da tag do formulário. 
Caso algum campo tenha sido preenchido de forma incorreta, essa função fará que 
o navegador exiba uma mensagem de alerta ao usuário. A figura 24 mostra um 
exemplo de mensagem que pode ser exibida. 


sH voltar ~ 


| Endereço [E] 


Preencha o formulário para se cadastrar no site 


Herne: flaliano Niederauer 


E-mail: juliano ®niederauercor SN . 
K t Por favor selecione o estado. 


Estado: [Escolha aqui w | 


| 


Senha: | 
Confirme sua senha: | 
Enviar | 


$$] Concluído E 


EE Intanetiocal 
Figura 2.4 — Validando os campos no lado do cliente. 


Se todos os campos tiverem sido preenchidos corretamente, os dados do formu- 
lário serão enviados ao programa cadastro.php, especificado na opção action da tag 
do formulário. Esse programa PHP fará a verificação dos campos, agora no lado do 
servidor, o que irá garantir a validação dos dados mesmo que o usuário remova a 
função JavaScript existente na página cadastro.html. 
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Acompanhe, então, o código do programa cadastro.php apresentado a seguir. 
Lembre-se de que o primeiro passo a ser dado é obter os dados do formulário, 
acessando o array superglobal $_POST. 


Fan 


& cadastro.php 


<?php 

fnome = $ POST[ "nome"; 

$email = $. POSTL"email"]; 

$estado = $ POST["estado"]; 

STogin = $_POST["login"]; 

$senha = $. POST["senha”"]; 

$confirmacao = $ .POST["confirmacao"]; 

// elimina os erros mais comuns na digitação de e-mails 


$email = str replace (" ", "", $email); 
$email = str. replace ("/", "", $email); 
$email = str replace ("@.", "Q”, $email); 
$email = str replace (".0º, "a", $email); 
$email = str. replace (",", ".", $email); 
$email = str. replace (";", ".", $email); 
$erro = 0; 

// verifica nome 

if (empty ($nome)) { 


Serro = 1; 
$msg = "Por favor, digite seu nome corretamente.”; 
} 
// verifica e-mail 
elseif (strlen(Semail) < 8 || substr count(Semail, "00 != 1 
|| substr count(Semail, ".") == 0) É 
Serro = 1; 
$msg = "Por favor, digite seu e-mail corretamente.”"; 


} 
// verifica Estado 
elseif (strlen($estado) != 2) | 
Serro = 1; 
$msg = "Por favor, escolha seu estado.”; 
} 
// verifica login 
elseif (strlen(Slogin) < 5 |] strien($login) > 15) { 
$erro = 1; 


$msg = "O nome de usuário (login) deve ter entre 5 e 15 caracteres. "; 
} 
elseif (strstr ($login, ' ') != FALSE) { 

$erro = 1; 

$msg = "O nome de usuário (login) não pode conter espaços em branco. "; 
} 
// verifica senha 
elseif (strlen($senha) < 5 || strlen($senha) > 15) | 


Serro = 1; 
$msg = "A senha deve ter entre 5 e 15 caracteres”; 


74 PHP para quem conhece PHP 


elseif (strstr ($senha, ' ') != FALSE) { 
$erro = 1; 
$msg = "A senha não pode conter espaços em branco, "; 
} 
// compara senha com a confirmação da senha 
elseif ($senha != $confirmacao) { 
$erro = 1; 
$msg = "Você digitou duas senhas diferentes." ; 


} 
// se ocorreu erro, exibe a mensagem de erro 
if (Serro) 
{ 
echo "<html><body>"; 
echo "<p align=center>$msg</p>"; 
echo "<p align=center><a href='javascript:history.back()'>Voltar</a></p>"; 
echo "</body></html>"; 
3 
else 
{ 
// tratar os dados aqui (ex: gravar no banco de dados) 
echo "<html><body>"; 
echo "<p align=center>Seu cadastro foi realizado com sucesso!</p>"; 
echo "</body></html>"; 
} 
?> 


Veja que foi utilizada uma variável chamada $erro, para indicar quando algum 
campo possui um valor inválido, e uma variável chamada $msg, para armazenar a 
descrição do erro, que posteriormente será exibida na tela. As funções de verificação 
utilizadas foram as mesmas apresentadas no decorrer deste capítulo (strstr, strlen e 
substr.count) e mais a função empty, que testa se uma variável está vazia. 


Ao final do programa, se algum erro foi encontrado, a descrição desse erro é 
exibida na tela com um link para o usuário voltar à página do formulário. Para a 
criação desse link, utilizou-se uma função do JavaScript chamada history.back(), 
que direciona o usuário à página anterior, sem limpar os dados que haviam sido 
digitados no formulário. 


É claro que para o programa cadastro.php ter alguma utilidade, é necessário dar 
algum tratamento aos dados recebidos, como, por exemplo, gravá-los em um banco 
de dados. Portanto, se você for adaptar esse programa para utilizá-lo em seu site, 
veja que há uma linha que contém o seguinte comentário: 


// tratar os dados aqui (ex: gravar no banco de dados) 


Então, você pode incluir nesse local o código de acesso a seu banco de dados, 
determinando assim um destino para as informações enviadas pelo usuário. 


Mantendo informações com cookies e sessões 


Neste capítulo, você irá entender a utilidade dos mecanismos de cookies e sessões 
oferecidos pelo PHP, além de aprender as principais funções utilizadas para imple- 
mentá-los. Será explicado também como realizar autenticação de usuários, assim 
como a criação de um sistema de usuário/senha, que atualmente faz parte de todos 
os sites que possuem conteúdo restrito aos usuários cadastrados no banco de dados. 
Ao final do capítulo, serão apresentadas a descrição e a sintaxe de cada uma das 
funções do PHP utilizadas para a manipulação de sessões. 


Por que usar cookies e sessões? 


Quando você acessa uma página web, a comunicação entre seu programa navegador e 
o servidor web é feita por meio de um protocolo chamado HTTP (Hypertext Transfer 
Protocol). O problema é que esse protocolo não armazena informações de estado, 
ou seja, trata de forma independente cada requisição de página que recebe. 


Por exemplo, se você acessar as páginas chamadas testel.html, teste2.htm] e teste3. 
html, e outra pessoa acessar essas mesmas três páginas, o servidor irá tratar esses 
acessos como sendo seis requisições independentes; não irá saber que foram duas 
pessoas que acessaram três páginas cada uma. Por essa razão é que os mecanismos 
de cookies e sessões são importantes, pois nos permitem armazenar informações 
que poderão ser utilizadas enquanto o usuário estiver navegando entre as páginas 
de nosso site. 


Isso é extremamente importante, visto que atualmente é cada vez mais necessário 
relacionar as diversas páginas acessadas pelo usuário. Esse relacionamento é feito 
pela manutenção das informações referentes às ações realizadas pelo usuário du- 
rante sua navegação no site. Entre algumas utilidades de cookies e sessões, podem 
ser citadas: 


15 
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= Autenticação de usuários: se seu site deve possuir áreas restritas, que só podem 
ser acessadas por usuários que se cadastrem, é importante que você saiba 
lidar com cookies ou sessões. Esses mecanismos permitem a criação de um 
sistema envolvendo login, autenticação e logout, o que garante o acesso do 
conteúdo somente aos usuários autorizados. 


= Carrinho de compras: o tradicional “carrinho de compras” é utilizado em pratica- 
mente todos os sites de comércio eletrônico. Precisamos armazenar todos os 
produtos já selecionados pelo cliente para compra, enquanto ele navega pelo 
site da loja. Cookies ou sessões podem ser usados para manter, por exemplo, 
o código de todos os produtos já adicionados no carrinho, e ao término da 
compra essas informações podem ser eliminadas. 


* Exibição de anúncios ou imagens: 'é muito comum que um site tenha diversos 
anúncios (ex.: banners de publicidade), ou, então, diversas imagens, e queira 
exibir uma diferente a cada acesso do usuário. Para não exibir mais de uma 
vez um mesmo anúncio ou imagem, é necessário manter informações sobre 
as que já foram exibidas. 


= Personalização de páginas: uma técnica interessante é personalizar o site de acordo 
com as páginas já visitadas pelo usuário. Por exemplo, uma livraria virtual 
poderia exibir o anúncio de um livro de culinária, caso o usuário tivesse feito 
uma pesquisa pela palavra “culinária” em páginas anteriores ou até na última 
vez que acessou o site. 


Essas são apenas algumas das aplicações que podem ser implementadas com o 
uso de cookies ou sessões. A partir de agora, veremos com detalhes cada um desses 
mecanismos. 


Utilizando cookies 


Cookie é um arquivo-texto que podemos armazenar no computador do usuário, para 
ser recuperado posteriormente pelo servidor. Um cookie é formado por um par nome/ 
valor, ou seja, possui um nome pelo qual é referenciado e um valor associado a esse 
nome. Pode ser utilizado em qualquer aplicação que necessite compartilhar dados entre 
diferentes páginas, ou até entre diferentes acessos (em dias e horários distintos). 


Algumas aplicações foram citadas no tópico anterior. Outro exemplo que pode 
ser implementado com cookies é a contagem de acessos de um usuário a seu site. 
Imagine que, na primeira vez que o usuário entra em seu site, você define um cookie 
chamado numero acessos, configurando seu valor como 1. No acesso seguinte, você 
obtém o valor desse cookie e o incrementa, passando para 2, e assim por diante. 
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Então poderia ser exibida uma mensagem ao usuário, como, por exemplo 


Você estã acessando este site pela segunda vaz 


Quero caso que pode ser citado é o do preenchimento automático de um campo 
de formulário, O site do PHP é um exemplo, pois se você acessá-lo hoje e fizer uma 
busca, por exemplo, pela função strlen, ao acessá-lo novamente no dia seguinte o o) 
campo de busca já estará preenchido com a palavra “ silen’. 


Ainda sobre preenchimento automático de um campo, falie você já tenha visto 
a seguinte mensagem, ao regressar a um site no qual você se cadastrou em outra 
oportunidade: l l 


Glá Fulanos: 
e logo a seguir um pequeno texto: 
(se você não for o Fulano, ia D 


Isso ocorreu porque na | última vez que você fez o login. no site foi armazenado 
um cookie em sua máquina, contendo seu nome. O aviso logo abaixo é exibido 
porque algumas máquinas, como, por exemplo, as dos laboratórios de informática, 
são acessadas por diferentes usuários, Dessa forma, o servidor pode resgatar o valor 
do cookie e exibi-lo para outra pessoa que está acessando o mesmo computador. 
Nesse caso, ao clicar o link‘ clique aqui”, é É acionado 1 um programa para eliminar 
os cookies. 


É possível especificar o tempo de validade de um cookie, ou seja, O tempo pelo 
qual permanecerá armazenado na máquina do usuário. Os cookies podem ser man- 
tdos na máquina do usuário por vários dias, ao contrário das sessões, que mantêm 
os dados somente enquanto q usuário permanecer em seu site. 


Invasão de privacidade? 


Existe uma discussão em torno da questão da privacidade em relação ao uso de 
cookies, Isso ocorre porque muitas vezes o usuário pode estar sendo “investigado”, 
ou seja, por meio das informações armazenadas nos cookies as empresas podem 

rastrear os sites pelos quais o usuário navegou, assim como conhecer seus hábitos 
de consumo e suas preferências. 


Por essa razão, os navegadores permitem ao usuário habilitar ou desabilitar Qar- 
mazenamento de cookies em sua máquina. Porém, não há como negar a importância 
desse mecanismo em um site que deseja oferecer um serviço de qualidade a seus 
usuários. O usuário que desabilitar os cookies do navegador não irá conseguir sequer 
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fazer o login em alguns sites. Além disso, é importante considerar os cookies como 
um recurso que visa a oferecer um serviço melhor, e não tratá-los como vilões. 


Em relação ao tipo de dados a ser armazenado, é claro que não seria nem um 
pouco elegante saturar a máquina do usuário de informações desnecessárias. Por- 
tanto, utilize cookies somente para armazenar alguns dados essenciais, como, por 
exemplo, um identificador, um nome de usuário (username), algum parâmetro de 
configuração definido pelo usuário etc. 


Enviando cookies pelo PHP 


O PHP nos oferece a função setcookie, que envia cookies para o computador do 
usuário. Essa função é usada tanto para definir um cookie como para excluí-lo. 
Sua sintaxe é a seguinte: 


bool setcookie (string nome [, string valor [, int validade [, string caminho 
[, string domínio [, int seguro]]]1]) 


Parâmetro Descrição 


nome Indica o nome do cookie que está sendo enviado, sendo o único parâ- 
metro obrigatório para a função. 


valor E o valor do cookie. Se não for fornecido, o servidor tentará excluir o 
cookie com o nome especificado. 


validade Define o tempo de validade do cookie. Deve ser expresso no formato- 
padrão de tempo do Unix (número de segundos após 1º de janeiro de 
1970, às 0h). 


caminho Caminho no servidor para o qual o cookie estará disponível. Se for 
definido o valor “/”” estará disponível para todo domínio especificado 
no parâmetro domínio. O valor-padrão é o diretório corrente a partir 
do qual o cookie foi definido. 


domínio Domínio para o qual o cookie estará disponível. 

seguro E um valor inteiro (0 ou 1), que indica se o cookie é seguro. Se for uti- 
lizado o valor 1, o cookie só será transmitido se a conexão for segura 
(HTTPS). 


Se for utilizado somente o parâmetro nome, o servidor tentará excluir o cookie 
do computador do usuário. Portanto, para definir um cookie, devemos utilizar no 
mínimo os parâmetros nome e valor. Exemplo: 


nn 


setcookie ("nome”,"Juliano"); 


Para excluir o cookie criado anteriormente, basta executar o comando: 


setcookie ("nome"); 
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Para criar, por exemplo, um cookie válido por 2 dias (48 horas), podemos utilizar 
como auxílio a função time do PHP. Exemplo: 


setcookie ("nome", "Juliano", time) + 172800); 


Esse cookie é válido por 2 dias, pois utilizamos a função time para obter o tempo 
atual e somamos 172.800 segundos, que equivalem a 48 horas. Esse resultado foi 
passado como o parâmetro validade para a função setcookie. 


Caso você não queira passar algum parâmetro intermediário, utilize uma string 


“> 


vazia (“”) para substituí-lo, com exceção dos parâmetros validade e seguro, pois estes 


an 


devem conter valores numéricos. Nesse caso, utilize zero (0) em vez de 


Importante: o envio de cookies deve ser o primeiro passo a ser dado na exe- 
cução da página, ou seja, a função setcookie deve ser utilizada antes de qualquer 
tag HTML, como, por exemplo, as tags <HTML> e <80DY>. Se for utilizada após as tags 
do HTML, o PHP irá exibir uma mensagem de erro, dizendo que a função foi 
chamada após o envio dos cabeçalhos. Essa é uma limitação do protocolo HTTP, 
mas se você quiser contorná-la, poderá utilizar funções de bufferização da saída, 
como ob. start) e ob end fush), ou habilitar a diretiva output_buffering do arquivo de 
configuração php. ini. 


O array superglobal $ COOKIE 


Agora que você já aprendeu a enviar cookies para o computador do usuário, vamos 
ver como recuperar esses valores em seus programas PHP Após definidos, os cookies 
estarão disponíveis para toda requisição de páginas feita pelo usuário ao servidor. 


E importante lembrar que os cookies não poderão ser utilizados dentro da 
própria página que os criou. Poderemos utilizá-los somente a partir da solicitação 
seguinte de página vinda do programa navegador do usuário. 


Existem duas formas de acessar, por meio do PHP, os cookies enviados para a 
máquina do usuário. Uma delas, e a mais recomendada, é por meio do array super- 
global $_C00KIE (em versões mais antigas era chamado de $HTTP. COOKIE VARS). Devemos 
utilizar o nome do cookie como chave associativa desse array. Por exemplo, se você 
definiu um cookie chamado nome: 


setcookie ("nome”,"Juliano"): 


Na página seguinte acessada pelo usuário, esse valor poderá ser acessado da 
seguinte maneira: 


$. COOKIE ["nome”"] 
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A segunda forma de acessar o valor de um cookie funciona apenas se a diretiva 
register globais estiver habilitada no php. ini. Nesse caso, você pode utilizar o próprio 
nome do cookie como uma variável. Por exemplo, o cookie nome seria referenciado 
pela variável $nome. 


Autenticação de usuários 


Conforme citado no início do capítulo, uma aplicação interessante de ser imple- 
mentada com cookies é a autenticação de usuários. A autenticação é uma maneira 
que você tem de se certificar de que somente os usuários que possuem autorização 
estão acessando uma área restrita de seu site. 


O PHP pode trabalhar com um método de autenticação baseado no servidor web, 
por meio do envio de cabeçalhos de HTTP. Nesse método, utiliza-se uma função do 
PHP chamada de header. Porém, esse não é um método que pode ser generalizado, 
pois funciona principalmente com o servidor web Apache. 


Uma das melhores maneiras de fazer a autenticação de usuários é com o uso de 
cookies, pois esse método nos garante uma autenticação segura e confiável, sendo 
aceito pela maioria dos servidores web. Além disso, com o uso de cookies pode- 
mos armazenar outras informações além dos dados de autenticação. Podemos, por 
exemplo, construir um carrinho de compras, para uma loja virtual, armazenando 
os produtos comprados enquanto o usuário navega pelas páginas da loja. 


Podemos dividir a autenticação de usuário por cookies em três etapas: 


1. criação de uma página de login, que recebe os dados do usuário, verifica se 
ele está cadastrado e cria os cookies; 


2. criação de uma rotina de validação para ser utilizada nas páginas que fazem 
parte das áreas restritas; 


3. criação de uma página de logout para os usuários que estão autenticados 
(realizar exclusão dos cookies). 


O único problema na utilização desse mecanismo é que os programas navegado- 
res permitem ao usuário desabilitar o recebimento de cookies para aumentar o nível 
de segurança de sua conexão. Por padrão, os navegadores aceitam o recebimento de 
cookies, mas se, por exemplo, um usuário acessar as opções de seu Internet Explorer 
e escolher um nível de segurança máximo, os cookies não funcionarão, ou seja, não 
poderemos armazenar qualquer informação no computador do usuário e, dessa 
forma, a autenticação não poderá ser feita. 
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Mesmo assim, a autenticação por cookies é um grande recurso que temos a nossa 
disposição, e vale a pena utilizá-lo, mesmo que tenhamos que avisar aos usuários 
que eles devem ativar o recebimento de cookies em seus navegadores para poder 
utilizar o site. 


Criando um sistema de username/senha para seu site 


Os sistemas de username/senha vêm sendo cada vez mais utilizados em diversos 
tipos de sites. Até mesmo os sites que possuem conteúdo totalmente gratuito estão 
exigindo o cadastramento dos usuários, pois essa é uma forma de conhecer o perfil 
das pessoas que os acessam. Outros utilizam esses sistemas para proteger um con- 
teúdo que não é gratuito, permitindo o acesso somente de usuários autorizados. 


Veremos como criar um sistema de username/senha para seu site, utilizando 
um banco de dados para armazenar as informações dos usuários e cookies para 
implementar a autenticação. 


Nesse exemplo, vamos utilizar um banco de dados MySQL. A primeira tarefa a 
ser feita é criar uma tabela no banco de dados para armazenar os dados dos usuá- 
rios. Vamos utilizar como exemplo uma tabela que armazena nome, e-mail, cidade, 
estado, nome de usuário (username) e senha do usuário. Essa tabela será criada por 
meio do utilitário mysql, digitando o seguinte comando SQL: 


create table usuarios 

( 
username varchar(10) NOT NULL, 
senha varchar(10) NOT NULL, 
nome varchar(80) NOT NULL, 
emai] varchar(80) NOT NULL, 
cidade varchar(40) NOT NULL, 
estado char(2) NOT NULL, 
primary key (username) 


); 


Repare que utilizamos o campo username como chave primária (primary key), 
pois isso nos garante que não poderá haver nenhum username repetido em nosso 
banco de dados. Portanto, cada usuário possuirá uma identificação única, que será 
armazenada no campo username. 


Após a criação da tabela, você poderá utilizar os conhecimentos adquiridos no 
Capítulo 2 para criar um formulário de cadastramento de usuários. Basta criar um 
formulário com os campos listados anteriormente e enviar os resultados para um 
programa PHP que realize a inclusão na tabela de usuários por meio do comando 


INSERT do SQL. 
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Como o objetivo desse tópico é ensinar a autenticação, vamos considerar que o 
banco de dados já possui alguns usuários cadastrados. Se você ainda não criou um 
formulário de cadastro e quiser testar a autenticação, poderá incluir um registro 
apenas para fins de teste, digitando no MySQL: 


insert into usuarios values 
Cjuliano','teste', "JULIANO", 'julianoQniederauer.com.br','Porto Alegre", 'RS'3: 


Para facilitar o entendimento do código, vamos criar também uma include (ar- 
quivo com um código PHP para ser incluído em outras páginas) de conexão com 
o MySQL, para utilizarmos sempre que houver necessidade de acessar o banco de 
dados. Essa include será nomeada como conecta mysql .inc e será chamada durante o 
nosso sistema de autenticação: 


conecta mysql.inc 


<?php 

// configurações do banco de dados 

$servidor = "localhost" 

Susuario. bd = "juliano"; 

$senha bd = "12345"; 

$banco = "test"; 

$con = mysql comect($servidor, $usuario bd, $senha bd); 
mysql select. db ($banco); 

?> 


Altere as variáveis $servidor, $usuario. bd, $senha. bd e $banco de acordo com as confi- 
gurações de seu servidor de banco de dados. 


Login 


Após a criação da tabela e inclusão de alguns usuários, o passo seguinte é fazer um 
programa de login que recebe o username e a senha de um usuário, verifica se essas 
informações estão corretas, cria os cookies no computador do usuário e o direciona 
para a página inicial para usuários do site. 


Vamos supor que na página inicial de seu site há um formulário com dois campos 
(username e senha) para o usuário fazer seu login, conforme mostra a figura 31: 
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Figura 3.1 — Formulário de login. 


O código dessa página, nomeada como login.html, é o seguinte: 


login.html 


<html> 

<body> 

<form method="POST" action="login.php”> 
<p align="center">Nome usuário: <input type="text” name="username” size="10"></p> 
<p align="center">Senha: <input type="password" name="senha” size="10"></p> 
<p align="center"><input type="submit" value="Enviar" name="enviar"></p> 

</form> 

</body> 

</html> 


Ao clicar o botão Enviar, será ativado o programa login.php, que irá analisar as 
informações enviadas e retornar uma resposta para o usuário ou direcioná-lo para 
outra página. 


Vamos agora construir o programa login.php, que primeiro deve verificar se o 
usuário realmente está cadastrado e se a senha digitada está correta, para poste- 
riormente criar os cookies. Para acessar o banco de dados, utilizaremos a include 
conecta mysql. inc, criada no tópico anterior: 


& login.php 


<?php 

// obtém os valores digitados 

$username = $ POSTE "username”]; 

$senha = $. POST[" senha"l; 

// acesso ao banco de dados 

include "conecta mysql. inc”: 

$resultado = mysql. query ("SELECT * FROM usuarios where username = 'S$username'"); 
$linhas = mysql. num rows ($resultado); 
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if ($linhas == 0) // testa se a consulta retornou algum registro 
{ 
echo "<html><body>"; 
echo “<p align=\"center\">Usuário não encontrado!</p>"; 
echo “<p align=\"center\"><a href=VTogin.htmN">Voltar</a></p>"; 
echo "</body></html>":; 


} 
else 
{ 
if ($senha != mysql_result($resultado, 0, "senha")) // confere senha 
{ 
echo "<html><body>"; 
echo "<p align=\"center\">A senha está incorreta!</p>"; 
echo "<p align=\"center\"><a href= "Togin.htmIN">Voltar</a></p>": 
echo "</body></html>"; 
} 
else // usuário e senha corretos, Vamos criar os cookies 
{ 
setcookie("nome_usuario", $username); 
setcookie("senha usuario”, $senha): 
// direciona para a página Inicial dos usuários cadastrados 
header ("Location: pagina inicial.php'): 
} 
} 
mysql_close($con); 
?> 


Veja que primeiro foi feita uma consulta ao banco de dados para verificar se o 
usuário existe. Se não existir, é exibida a mensagem “Usuário não encontrado” Se 
existir, a senha digitada é comparada com a senha gravada no banco de dados e, 
se forem iguais, o login é realizado com a criação dos cookies e o direcionamento 
do usuário à página principal. 


Nesse exemplo, considerou-se que a página principal de seu site (depois do login) 
se chama pagina inicial.php. Caso utilize páginas com outros nomes, apenas faça a 
substituição desse nome. 


Autenticação 


Depois que o usuário fez o login, os cookies já foram armazenados na máquina dele. 
Agora, a cada página que ele for acessar, devemos verificar se os cookies realmente 
existem e se contêm as informações corretas. Devemos fazer isso para evitar que o 
usuário digite diretamente o endereço de uma página, sem passar pelo login. 


Para fazer essa verificação e validação dos cookies, vamos criar uma include 
chamada valida cookies.inc, que deve ser chamada pelas páginas que devem ser 
protegidas. 
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Acompanhe, então, o código apresentado a seguir. Note que nas primeiras 
linhas, antes de obter o valor dos cookies, testamos se realmente estão definidos 
por meio da função Isset do PHP. É recomendável fazer esse teste para evitar que o 
PHP exiba alguma mensagem de erro ao tentarmos acessar um elemento que não 
existe no array $ COOKIE. 


Em valida cookies.inc 


<?php 
if (IsSet($. COOKIE ["nome usuario"])) 
gnome usuario = $ COOKIE["nome usuario"); 
if (IsSet($..COOKTE[" senha usuario"])) 
$senha usuario = $. COOKIE["senha usuario"]; 
if (! CemptyCfnome usuario) OR empty($senha usuario))) 


{ 
include "conecta_mysql.inc"; 
$resultado = mysql_query("SELECT * FROM usuarios WHERE username='$nome_usuario'"); 
if (mysql num rows($resultado) == 1) 
{ 
if ($senha usuario != mysql_result($resultado, 0, "senha")) 
{ 
setcookie("nome_usuario"); 
setcookie("senha usuario"); 
echo "Você não efetuou o LOGIN!"; 
exit; 
} 
} 
else 
{ 
setcookie("nome_usuario"); 
setcookie("senha_usuario"); 
echo "Você não efetuou o LOGIN!"; 
exit; 
} 
} 
else 
{ 
echo "Você não efetuou o LOGIN!"; 
exit; 
} 
mysql_close($con); 
?> 


Esse programa verifica a existência e a validade dos cookies. Caso não existam, 
é mostrada a mensagem: “Você não efetuou o LOGIN! Se os cookies existirem, 
mas forem inválidos, serão excluídos pela função setcookie e será mostrada a mesma 
mensagem, informando que o login deve ser feito. 


Agora, basta colocar uma chamada para essa include no topo de todas as páginas 
que devem ser protegidas: 


include "valida. cookies. inc”; 
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Uma consideração importante a ser feita é quanto à segurança das informações 
armazenadas. Como os cookies são arquivos-texto, qualquer pessoa que descobrir 
onde estão armazenados poderá visualizar seu conteúdo. Por isso, seria interessante 
armazenar a senha do usuário de forma criptografada em um cookie. Para crip- 
tografar um dado, devemos utilizar a função crypt do PHP. Essa função não tem 
volta, ou seja, não podemos decodificar um dado que foi criptografado. Portanto, no 
momento de fazer uma comparação com a senha do banco de dados, esta também 
deve ser criptografada antes de testarmos se as duas são iguais. 


O próximo tópico mostra como proceder quando o usuário vai sair do site, ou 
seja, quando vai efetuar logout. 


Logout 


Para o sistema de username/senha ficar completo só está faltando a construção de 
um programa de logout do usuário. Esse programa é importante porque o usuário 
pode querer continuar navegando por outros sites, ou seja, 0 programa navegador 
dele continua aberto, mas ele continua “logado” em seu site, embora não o esteja 
mais utilizando. Em muitos lugares, um computador é utilizado por mais de uma 
pessoa, e se não houver um programa de logout, pode ocorrer de uma pessoa pegar 
uma conexão que a outra deixou aberta e acessar uma área restrita de seu site. 


O programa de logout nada mais é do que a exclusão dos cookies criados no 
momento do login, que armazenam a senha e o nome de usuário: 


& logout.php 


<?php 
setcookie("nome_usuario"); 
setcookie("senha usuario"); 
header ("Location: Togin.html"); 
?> 
Esse programa exclui os cookies nome usuario e senha usuario e redireciona o nave- 
gador para a página de login. A partir desse momento, o usuário só poderá acessar 
o site se fornecer sua identificação novamente. 


Podemos colocar em todas as páginas do site um link para que o usuário possa 
fazer o logout a qualquer momento: 


<a href="Togout. php">LOGOUT</a> 


Por exemplo, sua página inicial poderia ter a seguinte estrutura, incluindo a 
chamada para a include de validação e um link para realizar o logout: 
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pagina inicial.php 


<?php 

include "valida cookies. inc”; 

?> 

<html> 

<body> 

Seja bem-vindo ao meu site! ! I<br> 

Coloque o conteúdo do seu site aqui neste espaço. <br> 
<p><a href="Togout. php">LOGOUT</a></p> 

</body> 

</html> 


Dessa forma, se o usuário tentasse acessar pelo navegador diretamente o arquivo 
pagina inicial.php, sem passar pelo login, o sistema de autenticação não iria permitir 
a visualização da página. 


Utilizando sessões 


O suporte a sessões foi adicionado na versão 4 do PHP. A partir de agora, veremos 
alguns conceitos relativos às sessões, além das funções do PHP utilizadas para 
manipulá-las. 


0 que é uma sessão? 


Uma sessão (session) é um período de tempo durante o qual uma pessoa navega 
pelas páginas de um site. Quando um usuário entrar no site, podemos abrir uma 
sessão e nela registrar diversas variáveis, que poderão ser acessadas a qualquer 
momento, em qualquer página do site, enquanto a sessão estiver aberta. 


Enfim, assim como os cookies, as sessões também permitem o compartilha- 
mento de dados entre diferentes páginas. Há algumas diferenças em relação aos 
cookies, como, por exemplo, o tempo de duração. Normalmente uma sessão dura 
enquanto o usuário permanecer dentro de seu site, enquanto um cookie pode 
permancer armazenado mesmo quando o usuário sair do site ou até quando ele 
fechar o navegador. 


Outra diferença é o local de armazenamento dos dados. Já vimos que os cookies 
são pequenos arguivos que ficam armazenados na máquina do usuário. No caso 
das sessões, os dados são armazenados em arquivos localizados no servidor (um 
arquivo por sessão). 


Quando um usuário entra no site e criamos uma sessão, esta recebe um número 
identificador único chamado de session id. Para uma página ter acesso aos dados 
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da sessão, deve conhecer esse identificador. O próximo tópico explicará como pode 
ser feita a propagação desse identificador de sessão entre as páginas. 


Propagando o identificador entre as páginas 

Para transmitir o identificador da sessão entre as páginas, existem duas formas: 
= cookies; 
* propagação de variáveis na URL (endereço destino). 


A primeira forma armazena o identificador da sessão em um cookie na máquina 
do usuário e o utiliza como referência para acessar os dados da sessão no servidor. 
Trata-se do melhor método e, por padrão, está habilitado pela diretiva session.use. 
cookies do arquivo php. ini. Porém, como nem sempre está disponível (o usuário pode 
desabilitar os cookies), pode ser utilizado o segundo método como alternativa. 


O segundo método consiste em propagar o identificador da sessão por meio da 
URL, o que pode ser feito de duas formas. Se no momento da compilação do PHP foi 
ativado o parâmetro -enable-trans-sid (desde a versão 4.20, esse parâmetro está sempre 
ativado), a identificação da sessão será enviada transparentemente entre as páginas, 
não sendo necessário colocá-la ao final da URL. Se esse parâmetro não foi utilizado no 
momento da compilação do PHP, deveremos acrescentar ao final da URL a constante 
SID, que o PHP cria automaticamente no início de uma sessão. Por exemplo: 


tu 


echo '<a href="pagina.php?'. SID .'">Clique aqui</a>'; 


Sempre que possível, utilize o primeiro método (cookies), pois além de oferecer 
melhor gerenciamento da sessão, também oferece mais segurança. 


Criando uma sessão no PHP 


No PHP, uma sessão pode ser criada de forma manual ou automática. A criação 
manual pode ser feita de forma explícita (função session_start) ou implícita (ao 
registrar uma variável com a função session register). 


A forma automática consiste em habilitar a diretiva session. auto. start do arquivo 
php. ini. Assim, sempre que um usuário entrar em seu site, será automaticamente 
criada uma sessão. 


A função session start serve tanto para criar uma sessão como para restaurar os 
dados uma sessão com base no identificador corrente (passado pelos métodos GET, 
POST ou por cookie). Essa função não possui parâmetros: 


bool session start (vazio) 
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Se estiver usando o método dos cookies para armazenar o identificador da 
sessão, deve chamar a função session start antes de qualquer saída produzida pelo 
navegador: 


<?php 
session start(); 


?> 


Registrando variáveis em uma sessão 


Ao registrarmos uma variável em uma sessão, estamos tornando-a disponível para 
todas as páginas que serão acessadas até o término dessa sessão. Existem duas 
formas de registrar uma variável: 


* usando a função session register, que permite registrar uma ou mais variáveis 
na sessão corrente; 


bool session register (misto nome [, misto...]) 


« adicionando diretamente entradas ao array superglobal $ SESSION. 


A segunda alternativa é mais recomendada, pois a primeira pode apresentar pro- 
blemas caso a diretiva register globals do php.ini esteja desabilitada. Recomenda-se 
usar diretamente o array superglobal $ SESSION por questões de segurança e também 
para melhorar a legibilidade do código. Esse array está disponível desde a versão 
410 do PHP Para versões anteriores, pode-se usar O SHTTP. SESSION. VARS. 


Se você utilizar o array $ SESSION, não será necessário usar funções como ses- 
sion register, session unregister nem session is registered. Vamos ver alguns exemplos 
de registro de variáveis. Acompanhe o código a seguir: 


<?php 

session start); 

if (lisset($_SESSION['contador'])) { 
$_SESSION['contador'] = 1; 

} else { 
$_SESSION[' contador ' ]++; 

} 


?> 


Nesse código, uma sessão é inicializada com a função session_start e, logo após, 
é utilizado o comando isset (Is Set, ou seja, está definido) do PHP para ver se a va- 
riável de sessão chamada contador já existe. Se não existir, será criada com o valor 1, 
caso contrário seu valor atual será incrementado. 
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Vejamos, agora, outro exemplo. Para testar o registro de variáveis em uma sessão 
e o uso desses valores em outra página, vamos criar duas páginas chamadas paginal. 
php e pagina2.php. Na primeira, serão definidas três variáveis de sessão e será exibido 
um link para a segunda página. Na segunda, serão exibidos os valores dessas três 
variáveis por meio do comando echo do PHP. O código da primeira é o seguinte: 


pagina?.php 


<?php 

session start (); 

echo 'Esta é a primeira página"; 

$ SESSIONT 'nome'] = "Juliano"; 

$ SESSIONT' sobrenome'] = 'Niederauer"; 
$_SESSION['data'] = date('d/m/Y', time); 
echo '<br><a href="pagina2.php">Página 2</a>"; 
?> 


Após Iniciar a sessão, as variáveis nome, sobrenome e data foram registradas por meio 
de uma atribuição direta a seus respectivos elementos no array $. SESSION. Logo após, 
foi exibido um link para a segunda página, que irá mostrar esses valores na tela. 
Nesse exemplo, estamos supondo que esteja em uso o mecanismo dos cookies 
para propagação do identificador da sessão. Porém, se você estiver propagando 
o identificador através da URL, poderá exibir o link usando a constante SID, da 
seguinte forma: 


echo "<br><a href="pagina2.php?'. SID .'">Página 2</a>"; 


Na segunda página, basta restaurar os dados da sessão com o comando ses- 
sion start e exibir os valores das variáveis, acessando novamente o array $ SESSION. 
Acompanhe o código apresentado a seguir: 


pagina2.php 


<?php 

session start(); 

echo "Esta é a segunda página <br>"; 

echo $ SESSION[ "nome'] . "<br>"; 

echo $ SESSIONT sobrenome" 1 . "<br>"; 

echo $. SESSIONL 'data'] . "<br>"; 

echo ‘<br><a href="paginal.php">Página 1</a>"; 
?> 


Caso você não utilize alguma variável da sessão nos próximos acessos, é possível 
eliminá-la. Se a diretiva register_globals do php. ini estiver desabilitada, isso poderá 
ser feito pelo comando unset do PHP. Exemplo: 


unset($ SESSIONT'nome'J); 
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Se a diretiva register_globals do php.ini estiver habilitada, então você poderá eli- 


minar uma variável de sessão por meio da função session unregister. Exemplo: 


session unregister('nome '); 


Parâmetros de configuração 


O gerenciamento das sessões pode ser configurado por meio do arquivo php.ini, 


que é um arquivo de configuração do PHP. Veja na tabela a seguir os principais 


parâmetros disponíveis: 


Parâmetro 


Descrição 


session.save handler 
session.save path 


session.name 


session.auto start 
session.serialize handler 
session.gc probability 
session.gc maxlifetime 
session. referer. check 


session.entropy.file 


session.entropy. length 


session.use cookies 


session. use only cookies 


session. cookie lifetime 


session.cookie path 


session.cookie domain 


Nome do manipulador para armazenar e recuperar dados 
de uma sessão. O padrão é files. 


Parâmetro que será passado para a rotina de armazena- 
mento (ex.: diretório onde serão criados os arquivos). 


Nome da sessão. O valor-padrão é PHPSESSID. 


Define se uma sessão deve ser iniciada automaticamente 
quando houver uma requisição do usuário. O padrão é 0. 


Define como os dados da sessão serão serializados; o 
padrão é php, um formato interno do PHP 


Define a probabilidade (em percentual) de execução da 
rotina gc (garbage collection) a cada requisição. 


Número de segundos que deve ser esperado para que os 
dados armazenados sejam descartados. 


Permite definir uma substring para verificar se está contida 
na requisição HTTP. 

Caminho para um recurso externo (arquivo) que será 
usado no processo de criação do identificador da sessão 
(ex.: /dev/random). 

Número de bytes que deve ser lido a partir do recurso 
especificado no parâmetro session. entropy_file. 

Indica se serão utilizados cookies para armazenar o iden- 


tificador da sessão na máquina do usuário. O padrão é 1 

(habilitado). 

Indica se devem ser usados somente cookies para arma- 

zenar o identificador da sessão. E usado para prevenir 

possíveis ataques de passagem do identificador através 

da URL. O padrão é O (desabilitado). 

Define em quanto tempo (em segundos) os cookies envia- 

dos expiram. O padrão é 0, ou seja, até que o navegador 
8 

seja encerrado. 

Define o caminho no qual o cookie é válido. O padrão é /. 


Define o domínio no qual o cookie é válido. 


92 PHP para quem conhece PHP 


Parâmetro Descrição (cont.) 


session.cookie secure Se habilitado, os cookies serão enviados apenas se a 
conexão for segura (HTTPS). 


session.cache limiter Define o método de controle de cache usado para as 
páginas da sessão. O padrão é nocache. Outros valores 
possíveis são none, private, private no expire e public. 


session.cache expire Especifica o tempo (em minutos) de validade para as 
páginas de sessão armazenadas na cache. Só tem efeito se 
o método utilizado não for o nocache. O padrão é 180. 


session.use trans sid Indica se a propagação transparente do identificador da 
sessão está habilitada. O padrão é O (desabilitada). 

session.bug. compat 42 Permite desabilitar uma característica da versão 4.2 do 
PHP, que possibilita inicializar variáveis de sessão no 
escopo global. 


session.bug compat warn E complementar ao parâmetro anterior. Indica se deve 
ser exibido um aviso caso o usuário tente usar essa ca- 
racterística, 

url rewriter.tags Define as tags HTML que devem ser reescritas para 


inclusão do identificador de sessão, quando o modo 
transparente estiver habilitado. 


Usando sessões no sistema de username/senha 


Veremos agora como alterar o sistema de username/senha apresentado no tópico 
sobre cookies, para que passe a utilizar sessões. Portanto, antes de ler as próximas 
páginas, é importante que você tenha entendido como funciona o sistema apresenta- 
do no tópico Criando um sistema de username/senha para seu site. Nesse exemplo, 
será utilizada a mesma tabela usuarios (criada no tópico referido) para armazenar 
as informações sobre os usuários. 


Lembre-se de que o sistema de username/senha possui três partes fundamentais: 
login, autenticação e logout. 


Começaremos apresentando o login, ou seja, a entrada do usuário no site me- 
diante o fornecimento do nome de usuário e senha. 


Login 


O formulário de login, no qual o usuário irá digitar seus dados, será o mesmo apre- 
sentado no sistema que utiliza cookies. Esse arquivo foi nomeado como login.html e 
contém um formulário com os campos username e senha. Quando o usuário preencher 
os campos e enviar os dados, será ativado o programa 1ogin.php, responsável por 
acessar o banco de dados e verificar se os dados digitados estão corretos. 
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Se os dados digitados conferirem com os do banco de dados, o programa que 
antigamente criava os cookies agora deverá registrar esses dados como variáveis de 
uma sessão. Portanto, em relação ao antigo login.php, devemos alterar apenas o trecho 
onde as variáveis serão registradas. Não podemos esquecer-nos também de incluir 
uma chamada para a função session start, para a criação da sessão. Acompanhe, 
então, como ficaria o novo programa: 


login.php 


<?php 
// obtém os valores digitados 
$username = $ POST[ "username" ]; 
$senha = $ POST[ "senha" ]; 
// acesso ao banco de dados 
include "conecta mysql.inc”; 
$resultado = mysql query("SELECT * FROM usuarios where username=' Susername'") ; 
$linhas = mysql. num rows ($resultado); 
if ($linhas == 0) // testa se a consulta retornou algum registro 
{ 
echo "<html><body>"; 
echo "<p align=\"center\">Usuário não encontrado!</p>"; 
echo "<p align="center '><a href= "Togin.htmIN">Voltar</a></p>"; 
echo "</body></html>"; 


} 
else { 
if ($senha != mysql_result($resultado, 0, “senha")) // confere senha 
{ 
echo "<html><body>"; 
echo "<p align=\"center\">A senha está incorreta!</p>"; 
echo "<p align=\"center\"><a href=\"1ogin.html\">Voltar</a></p>"; 
echo "</body></html>"; 
} 
else // usuário e senha corretos. Vamos criar os cookies 
{ . 
session start(); 
$ SESSION[' nome usuario'] = $username; 
$ SESSION[' senha usuario'] = $senha; 
// direciona para a página inicial dos usuários cadastrados 
header ("Location: pagina inicial.php'9; 
} 
} 
mysql. close($con); 
?> 


Veja que foram criadas as variáveis de sessão nome usuario e senha usuario, por meio 
de uma atribuição aos elementos com esses nomes no array $. SESSION. 
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Autenticação 


Após o usuário realizar o login, as variáveis de sessão estarão definidas e armaze- 
nadas no servidor. Agora, a cada página que ele acessar, deveremos verificar se as 
variáveis realmente existem e se contêm as informações corretas. Deveremos fazer 
isso para evitar que o usuário digite diretamente o endereço de uma página, sem 
passar pelo login. 


Para fazer essa validação utilizando sessões, vamos alterar a include que criamos 
no tópico sobre cookies, chamada valida cookies .inc, que agora passará a acessar as 
variáveis de sessão em vez dos cookies. O programa com as alterações será nomeado 
como valida sessao. inc. Veja no código a seguir que a primeira tarefa a ser feita é 
restaurar os dados da sessão por meio da função session start: 


valida sessao.inc 


<?php 
session start (); 
if (IsSet($ SESSION[ "nome usuario"])) 
$nome usuario = $ SESSION[ "nome usuario"); 
if (IsSet($ SESSIONT"senha usuario"])) 
$senha usuario = $ SESSION["senha usuario"): 
if (! Cempty($nome usuario) OR empty($senha usuario))) 


{ 
include "conecta mysql. inc"; 
$resultado = mysql_query("SELECT * FROM usuarios WHERE username='$nome_usuario'"); 
if (mysql_num_rows($resultado) == 1) 
{ 
if ($senha_usuario != mysql_result($resultado, 0, "senha")) 
{ 
unset ($ SESSION[' nome usuario']); 
unset ($ SESSION[ 'senha usuario"): 
echo "Você não efetuou o LOGIN!"; 
exit; 
} 
} 
else 
{ 
unset ($_SESSION['nome_usuario']); 
unset ($_SESSION['senha_usuario']); 
echo “Você não efetuou o LOGIN!"; 
exit; 
} 
} 
else 
{ 
echo "Você não efetuou o LOGIN!"; 
exit; 
} 


mysql_close($con); 
?> 
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Caso as variáveis de sessão não existam, aparecerá a seguinte mensagem: “Você não 
efetuou o LOGIN!” Se existirem, mas forem inválidas, serão eliminadas pela função 
unset e será mostrada a mesma mensagem informando que o login deve ser feito. 


Agora basta colocar uma chamada para essa include no topo de todas as páginas 
que devem ser protegidas: 


include “valida sessao. inc”; 


O próximo tópico mostra como proceder quando o usuário vai sair do site, ou 
seja, quando vai efetuar um logout. 


Logout 


Com o uso de sessões, o logout de usuários torna-se fácil de ser implementado, pois 
o PHP nos disponibiliza a função session destroy, que elimina todos os dados de 
uma sessão. No entanto, é importante destacar que essa função apenas encerra a 
sessão, mas não libera o espaço alocado para as variáveis registradas. Para eliminar 
essas variáveis, se você tiver o array $ SESSION, basta reiniciá-lo atribuindo-lhe um 
array vazio: 


$ SESSION = array (); 


Caso contrário, use o comando session unset, que tem a mesma finalidade. Veja, 
então, no código a seguir como poderia ser o programa de logout de usuários: 


£ logout.php 


<?php 

session start(); 

$ SESSION = array 0); 
session destroy): 


header ("Location: login.html"); 
?> 


Esse programa encerra a sessão atual, elimina todas suas variáveis e redireciona 
o usuário de volta para a página principal de seu site. A partir daí, ele só poderá 
acessar o conteúdo do site se fizer o login novamente. Note que, antes de destruir 
a sessão, foi necessário chamar a função session start para restaurar o ambiente da 
sessão atual. 


Poderíamos colocar em todas as páginas do site um link para que o usuário 
possa fazer o logout a qualquer momento: 


<a href="Togout. php">LOGOUT</a> 


96 PHP para quem conhece PHP 


Por exemplo, sua página inicial poderia ter a seguinte estrutura, incluindo a 
chamada para a include de validação e um link para realizar o logout: 


pagina_inicial.php 


<?php 

include “valida sessao. inc"; 

?> 

<html> 

<body> 

Seja bem-vindo ao meu site! ! !<br> 

Coloque o conteúdo do seu site aqui neste espaço.<br> 
<p><a href="logout. php">LOGOUT</a></p> 

</body> 

</html> 


Dessa forma, se o usuário tentasse acessar pelo navegador diretamente o arquivo 
pagina inicial.php, sem passar pelo login, o sistema de autenticação não iria permitir 
a visualização da página. 


Funções do PHP para manipulação de sessões 


A seguir, serão apresentadas a descrição e a sintaxe das funções que podemos utilizar 
no PHP para fazer o gerenciamento de sessões. 


session cache expire 


Retorna o tempo de validade atual da cache. Se o parâmetro validade cache for 
fornecido, seu valor será utilizado como o novo prazo de validade. 


int session cache expire ([int validade cachel) 


session cache limiter 


Obtém ou configura o método de controle de cache usado para as páginas 
da sessão. 


string session cache limiter ([string limitador cachel) 


session decode 
Decodifica dados de uma variável de sessão. 


bool session decode (string dados) 


session destroy 
Encerra uma sessão, eliminando todos os dados associados a esta. 


bool session destroy (vazio) 
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session encode 
Faz a codificação dos dados da sessão em uma string. 


string session encode (vazio) 


session get cookie params 


Retorna um array contendo informações sobre o tratamento de cookies na sessão 
atual. São retornadas informações como tempo de validade ("lifetime"), caminho 
de armazenamento ("path"), domínio ("domain") e segurança ("secure"). 


array session get cookie params (vazio) 


session id 
Obtém ou define a identificação da sessão (session id) atual. 


string session id ([string id]) 


session is registered 
Verifica se uma variável está registrada na sessão atual. 


bool session is registered (string nome) 


session module name 
Obtém ou define o nome do módulo da sessão atual. 


string session module name ([string módulo]) 


session name 
Obtém ou define o nome da sessão atual. 


string session name ([string nome]) 


session regenerate id 
Gera um novo identificador para a sessão atual. 


bool session. regenerate id (vazio) 


session register 


Registra uma ou mais variáveis na sessão atual. Se você utilizar diretamente o array 
superglobal $ SESSION para registrar variáveis, não precisará usar essa função. 


bool session register (misto nome [, misto ...)) 


session save path 


Obtém ou define o caminho de armazenamento para os dados da sessão 
atual. 


string session save path ([string caminho!) 
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session set cookie params 


Define os parâmetros para o tratamento de cookies que serão utilizados pela 
sessão atual. 


void session set cookie params (int validade [, string caminho [, string domínio 
[, bool seguro]]!) 
session set save handler 


Permite a definição de funções de armazenamento personalizadas para as 
sessões. Podem ser definidas funções para abertura, fechamento, leitura, 
escrita, encerramento e gc (garbage collection). 


bool session set save handler (string abrir, string fechar, string Ter 
string escrever, string destruir, string go) 
session start 
Cria uma sessão ou restaura os dados da seção atual, com base no identificador 


fornecido (passado pelos métodos GET, POST ou por cookie). 


bool session. start (vazio) 


session unregister 


Exclui uma variável da sessão. Se você estiver utilizando o array $. SESSION, use 
unset em vez dessa função. 


bool session unregister (string nome) 


session unset 


Elimina todas as variáveis da sessão atual. Se você estiver utilizando o array 
$ SESSION, reinicie o array com o comando $ SESSION=arrayQ) em vez de usar 
essa função. 


void session unset (vazio) 


session write close 


Armazena os dados da sessão e a encerra. É útil nos casos em que mais de 
um script pode acessar simultaneamente os dados de uma sessão, como, por 
exemplo, quando são usados frames. Nesses casos, encerrando uma sessão 
antes do fim do script, liberamos de forma mais rápida o bloqueio criado 
pelo sistema para evitar escritas concorrentes. 


void session write close (vazio) 


Arquivos-texto: praticidade e rapidez 


Neste capítulo, você irá aprender a utilizar arquivos no formato texto para armazenar 
dados e recuperá-los rapidamente, sem que haja necessidade de se conectar a um 
SGBD (Sistema Gerenciador de Banco de Dados), como o MySQL e o PostgreSQL. 
Veremos em quais situações é interessante realizar a manipulação de arquivos e 
conheceremos as principais funções disponíveis no PHP para executar essa tarefa. 
Serão apresentadas as principais operações, como abertura, fechamento, leitura e 
escrita de dados, não necessitando que haja um SGBD instalado no servidor. 


Por que utilizar arquivos no PHP? 


Em aplicações que exigem o armazenamento de poucos dados, às vezes não há ne- 
cessidade de utilizar um SGBD para armazená-los, pois isso torna o processo mais 
lento, visto que deve haver uma conexão com o banco de dados para realizar uma 
operação. Se o servidor de banco de dados estiver localizado em um outro host (outro 
servidor da rede), a situação se agravará, pois a rede poderá estar congestionada. 
Nesses casos, podemos trabalhar, por exemplo, diretamente com arquivos no formato 
texto, o que torna mais rápidos o armazenamento e a recuperação de dados. 


Entre as situações em que podemos utilizar a manipulação de arquivos em vez 
de um SGBD, podem ser citadas: criação de contadores de acessos para uma ou 
mais páginas do site, criação de um programa gerenciador de publicidade on-line 


(anúncios por meio de banners) e criação de fóruns de discussão ou livro de visitas 


(guestbook). 


Em todos os exemplos citados, os dados podem ser armazenados em simples 


arquivos no formato texto. É claro que não vamos utilizar esse tipo de arquivo para 


armazenar os dados dos usuários do site, pois além de não oferecer a segurança 
necessária, à manipulação desses dados (inclusão, alteração e exclusão) torna-se 
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extremamente difícil. Recomendamos o uso de arquivos somente quando o volume 
de dados for pequeno, evitando assim que se perca tempo com a utilização de um 
SGBD para realizar uma tarefa simples. 


Operando sobre arquivos 


A partir de agora veremos as principais operações que podemos realizar sobre 
os arquivos. O PHP nos oferece dezenas de funções capazes de trabalhar com o 
filesystem (sistema de arquivos) do sistema operacional. As principais operações 
que podemos realizar sobre um arquivo são abertura, leitura, escrita e fechamento. 
Portanto, veremos detalhadamente as funções que realizam essas tarefas. 


Abertura 


Para abrir um arquivo, utilizamos a função fopen, que possui a seguinte sintaxe: 


recurso fopen (string nome arquivo, string modo [, int usar include path 
[, recurso contexto]] 


Parâmetro Descrição 


ome do arquivo a ser aberto, que pode ser local ou remoto. Se 
or fornecido um URL, a abertura só irá funcionar se a diretiva 
allow_url_fopen estiver habilitada no php. ini. 


nome arquivo 


modo fodo de acesso ao arquivo. A lista dos modos disponíveis será 
apresentada logo a seguir. 

usar include path Indica se o arquivo deve ser procurado nos diretórios especifi- 
cados na diretiva include path do php. ini. 


contexto Permite a definição de um contexto, que consiste em um conjunto 
de parâmetros que modificam o comportamento do arquivo. O 
suporte a contextos foi adicionado ao PHP 5. 


O parâmetro nome arquivo pode referenciar um arquivo que está no mesmo com- 
putador ou em um computador remoto. Se esse parâmetro iniciar com “http: //”, 
será aberta uma conexão HTTP, que retornará um ponteiro para o arquivo que foi 
aberto. Se o nome do arquivo iniciar com “ftp://” será aberta uma conexão FTP 
antes da abertura do arquivo. 


Se a abertura não necessitar do estabelecimento de uma conexão HTTP nem 
FTP, o arquivo será aberto do filesystem da própria máquina e será retornado um 
ponteiro para esse arquivo. À função fopen retornará o valor falso se a abertura do 
arquivo falhar. 
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O segundo parâmetro da função fopen é o modo, que pode possuir os seguintes 
valores: 


Modo Descrição 


Abre somente para leitura, posicionando o ponteiro no início do arquivo. 


r+ Abre para leitura e escrita, posicionando o ponteiro no início do arquivo. 
tw! Abre somente para escrita, posicionando o ponteiro no início do arquivo 
e deixando-o com tamanho zero. Se o arquivo não existir, tenta criá-lo. 
tua! Abre para leitura e escrita, posicionando o ponteiro no início do arquivo 
e deixando-o com tamanho zero. Se o arquivo não existir, tenta criá-lo. 

'a! Abre somente para escrita, posicionando o ponteiro no final do arquivo. 
Se o arquivo não existir, tenta criá-lo. 

tas! Abre para leitura e escrita, posicionando o ponteiro no final do arquivo. 
Se o arquivo não existir, tenta criá-lo. 

'x' Cria e abre um arquivo somente para escrita, posicionando o ponteiro no 
início do arquivo. Se o arquivo já existir, retorna falso (FALSE) e gera um 
erro do tipo E WARNING. Disponível desde a versão 4.3.2 do PHP, esse modo 
é usado apenas em arquivos locais. 

'x+' Cria e abre um arquivo para leitura e escrita, posicionando o ponteiro no 


início do arquivo. Se o arquivo já existir, retorna falso (FALSE) e gera um 
erro do tipo E WARNING. Disponível desde a versão 4.3.2 do PHP esse modo 
é usado apenas em arquivos locais. 


Existe ainda a possibilidade de usar as letras ‘b’ ou ‘t’ como último caractere 
do parâmetro modo. A letra ‘b’ força o uso do modo binário, devendo ser usada em 
sistemas que diferenciam arquivos nos formatos binário e texto. A letra ‘t’ é usada 
em sistemas Windows para traduzir os caracteres de quebra de linha (qn) para rn. 
Veja alguns exemplos de uso da função fopen: 


<?php : 
$ponteiro = fopen ("/home/juliano/teste.txt", "r"); , 
$ponteiro = fopen ("/home/juliano/teste2.txt", "wb"); ` 
$ponteiro = fopen ("/home/juliano/teste2.txt", "a+"); 
$ponteiro = fopen ("http://www.teste.com.br", "r"); 

?> 


Se estiver com problemas para a criação ou abertura de um arquivo, verifique 
se você tem as devidas permissões para acessar o diretório no qual a gravação de- 
veria ser feita. Outro detalhe importante diz respeito aos sistemas Windows, onde 
devem ser acrescentados caracteres de escape ao utilizarmos as barras invertidas. 
Por exemplo: 


<?php 
$ponteiro = fopen ("c:\\teste\\arquivo.txt", "r'); 
?> 
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Fechamento 
Para fechar um arquivo, utilizamos a função fclose, que possui a seguinte sintaxe: 
bool fclose (recurso ponteiro arquivo) 


Essa função retorna true se o arquivo foi fechado com sucesso e false se houver 
alguma falha. O parâmetro passado para a função fclose deve conter a variável para 
a qual foi atribuído o resultado da função fopen, ou seja, o ponteiro (handle) para 
o arquivo que foi aberto. Exemplo: 


<?php 
Sponteiro = fopen('arquivo.txt", 'r'3: 


felose(Sponteiro); 
?> ` 


Leitura 


À seguir, serão apresentadas diversas funções que o PHP disponibiliza para fazer a 
leitura dos dados armazenados em um arquivo. Acompanhe as alternativas possíveis 
e utilize aquela que melhor se adaptar às necessidades de seu site. 


Especificando o número de bytes s 


Uma das formas de ler dados de um arquivo é utilizar a função fread, que permite 
especificar a quantidade de informações a ser lidas. Sua sintaxe é a seguinte: 


string fread (recurso ponteiro arquivo, int tamanho) 


Essa função lê o número de bytes especificado no parâmetro tamanho a partir 
da posição atual do ponteiro definido pelo primeiro parâmetro. A leitura termina 
quando o número de bytes especificado é lido ou o fim do arquivo (EOF — End Of 
File) é alcançado. Por exemplo: 


leitura.php 


<?php 

Sponteiro = fopen ("teste txt", "r'); 
$conteudo = fread (Sponteiro, 30); 
echo Sconteudo; 

fclose (Sponteiro); 

?> 


Esse programa abre um arquivo chamado teste. txt e lê seus 30 primeiros bytes, 
armazenando-os na variável $conteudo. Em seguida, o valor obtido é exibido na tela 
com o comando echo e o arquivo é fechado com fclose. 
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Obtendo uma linha inteira 


Outra forma de realizar a leitura de um arquivo é utilizando a função fgets. A 
diferença em relação ao fread é que a fgets lê, no máximo, uma linha. É bastante 
utilizada quando queremos trabalhar individualmente com cada linha do arquivo. 
Sua sintaxe é a seguinte: 


string fgets (recurso ponteiro arquivo [, int tamanho]) 


A leitura é feita até que seja lido o número de bytes especificados em tamanho, 
ou quando terminar a linha atual do arquivo (caractere in), ou quando o arquivo 
chegar a seu final. Se não for especificado o parâmetro tamanho, será utilizado o va- 
lor-padrão, que é 1024 bytes (1k). Como exemplo, considere o programa linha.php 
apresentado a seguir: 


linha.php 


<?php 

Sponteiro = fopen ("teste.txt", "r"); 
Slinha = fgets(Sponteiro, 4096); 

echo $linha; - 
fclose (Sponteiro); 

7> 


Esse programa lê a primeira linha de um arquivo, exibindo-a na tela. Note que 
se utilizou um valor bem alto (4096) para garantir a leitura da linha inteira. Se a 
função fgets fosse chamada novamente, seria retornada a segunda linha do arquivo, 
e assim por diante. 


Lendo um único caractere 


Se você precisar ler apenas um caractere por vez, uma opção é utilizar a função fgetc, 
que possui a seguinte sintaxe: 


string fgetc (recurso ponteiro arquivo) 


Se o ponteiro estiver posicionado no fim do arquivo e não houver mais caracteres 
a ser lidos, essa função retornará FALSE. Veja um exemplo: 


caracter. php 


<?php 
ponteiro = fopenC'teste. txt", 'r'); 
if Cl $ponteiro) 
echo 'Não foi possivel abrir o arquivo"; 
while ((Scaracter = fgetcCponteiro)) != false) 
echo $caracter; 
?> 
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Esse programa abre um arquivo chamado teste. txt e obtém um caractere por vez 
por meio da função fgetc, exibindo-os na tela com o comando echo. O programa será 
encerrado quando o resultado da operação for false, ou seja, quando não houver 
mais caracteres a ser lidos. 


Eliminando tags HTML e PHP do conteúdo 


Se você pretende ler o conteúdo de um arquivo e enviá-lo diretamente à saída do 
programa navegador, em alguns casos você pode precisar utilizar a função fgetss. 
Essa função elimina as tags HTML PHP existentes no conteúdo lido. Dessa forma, 
você pode evitar que o navegador interprete as tags em vez de exibi-las. 


Por exemplo, se no conteúdo lido houver o texto “<b>Novatec</b>” e este for exibido 
com o comando echo, será mostrada a palavra “Novatec” em negrito. Utilizando a 
função fgetss, podemos eliminar essas tags no momento da leitura. 


Como exemplo, considere o programa a seguir: 


tags.php 


<?php 

fponteiro = fopen ("texto. txt", "r"}: 

linha = fgetssCSponteiro, 4096); 

echo $linha; 

fclose CSponteiro): 

?> 

Esse programa obtém a primeira linha de um arquivo chamado texto. txt, remove 
as tags existentes nessa linha e logo após a exibe na tela. Supondo que a primeira 


linha do arquivo seja: 
Este livro foi publicado pela editora <b>Novatec</b>. 


O resultado será: 


Este livro foi publicado pela editora Novatec. 


Armazenando o conteúdo em uma string 


Se você quiser ler todo o conteúdo de um arquivo e armazená-lo em uma string, o 
PHP nos permite realizar essa tarefa utilizando apenas uma função, a file get contents, 
que possui a seguinte sintaxe: 


string file get.contents (string nome arquivo [, int usar include path [, recurso contexto]]) 
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Parâmetro Descrição 


nome arquivo Nome do arquivo a ser aberto. Se for fornecido um URL, a 
abertura só irá funcionar se a diretiva allow_url_fopen estiver 
habilitada no php. ini. 

usar include path Indica se o arquivo deve ser procurado nos diretórios especifi- 
cados na diretiva include path do php. ini. 


contexto Permite a definição de um contexto, que consiste em um conjunto 
de parâmetros que modificam o comportamento do arquivo, O 
suporte a contextos foi adicionado ao PHP 5. 


Na realidade, essa função nos oferece um modo mais simples de executar as ope- 
rações de abertura (fopen), leitura (fread) e fechamento (fclose) de um arquivo, pois 
essas três operações são realizadas com uma única chamada. Veja um exemplo: 


le conteudo string.php 


<?php 
fconteudo = file get contents ("teste. txt"); 


echo Sconteudo; 
?> 


Esse programa abre um arquivo chamado teste.txt, lê seu conteúdo (armaze- 
nando-o na variável $conteúdo) e o fecha-Em seguida, o conteúdo é exibido por meio 
do comando echo. 


Armazenando o conteúdo em um array 


Se em vez de armazenar o conteúdo de um arquivo em uma string, você quiser ar- 
mazená-lo em um array, o PHP nos disponibiliza a função file. Cada elemento do 
array resultante irá conter uma linha do arquivo. À sintaxe é a seguinte: 


array file (string nome arquivo [, int usar include path (, recurso contexto]]) 


Note que os parâmetros são exatamente os mesmos da função file get contents, 
apresentada no tópico anterior. Veja um exemplo: 


le conteudo array.php 


<?php 

Sarray = file ("teste. txt"); 

foreach (Sarray as $linha) 
echo flinha, "<br>"; 

7> 


Esse programa abre um arquivo chamado teste.txt, lê seu conteúdo (armaze- 
nando-o no array $array) e o fecha. Cada elemento do array irá conter uma linha 
do arquivo, ou seja, array[0) irá conter a primeira linha, array[1], a segunda linha, e 
assim por diante. Em seguida, cria-se um laço com o comando foreach para percorrer 
todos os elementos do array e exibi-los na tela com o comando echo. 
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Exibindo o conteúdo na tela 


O PHP possui ainda a função readfile, que obtém todo o conteúdo de um arquivo 
e o envia diretamente ao buffer de saída. A sintaxe é a seguinte: 


int readfile (string nome arquivo [, bool usar include path f, recurso contextol]) 


Veja que os parâmetros também são os mesmos da função file get contents apre- 
sentada anteriormente. Veja um exemplo: 
<?php 


$bytes = readfile ("teste.txt"}; 
?> 


Esse trecho de código irá abrir.um arquivo chamado teste. txt, exibir todo o seu 
conteúdo e logo após irá fechá-lo. 


Escrita 


Para escrever dados em um arquivo com o PHP, utilizamos a função fwrite, que 
possui a seguinte sintaxe: 


int fwrite (recurso ponteiro arquivo, string string L, int tamanho]) 


Essa função escreve o conteúdo do parâmetro string no arquivo referenciado 
pelo parâmetro ponteiro arquivo. O parâmetro tamanho é opcional. Se for informado, a 
escrita irá parar após ser atingido o número de bytes especificado. Veja um exemplo 
de uso dessa função: 


escrita.php 


<?php 

$conteudo = "Este texto será escrito no arquivo!"; 
fponteiro = fopen ("arquivo.txt", "w'): 
fwrite(Sponteiro, Sconteudo); 

fclose (fponteiro); 

7> 


Esse programa tentará abrir um arquivo chamado arquivo. txt no modo de escrita, 
eliminando seu conteúdo e posicionando o ponteiro no início do arquivo. Caso o 
arquivo não exista, o programa tentará criá-lo. Lembre-se de que para isso é neces- 
sário que o diretório possua permissão de escrita. 


Em seguida, utiliza-se a função fwrite para escrever a string armazenada na va- 
riável $conteudo no arquivo. Por fim, o arquivo é fechado com fclose. 
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Criando um contador de acessos 


Uma aplicação que pode ser criada com o uso de arquivos-texto é um contador de 
acessos para as páginas de seu site. Você pode criar um único contador para o site 
inteiro ou, então, criar scripts individuais para contar os acessos de cada página. 
Como exemplo, vamos criar um programa que armazena o valor atual em um ar- 
quivo chamado contador. txt e o incrementa a cada acesso. Esse programa será uma 
include nomeada como contador. inc, que posteriormente será incluída nas páginas 
que desejarmos realizar a contagem. Acompanhe o código apresentado a seguir: 


contador.inc 


<?php 

Sarquivo = "contador txt"; !f arquivo do contador 

if (File exists(Jarquivo)) f/ se existe, lê o valor atual e o incrementa 
{ 


$valor_atua] = file get contents(Sarquivo); 
$valor atual = chop(fvalor atual); 
valor atual++; 
} 
else 
ivalor atual = 1; 
!f grava o novo valor no arquivo 
fponteiro = fopen (Sarquivo, "w"); 
furite(Sponteiro, $valor atual); 
fclose (Sponteiro); 
?> 


Primeiramente, utiliza-se a função file exists para testar se o arquivo contador. txt 
já existe. Caso exista, obtemos seu valor atual utilizando a função file get contents 
e, logo após, o incrementamos. Note que nesse exemplo utilizamos a função chop 
do PHP no momento após a leitura do conteúdo do arquivo. Essa função tem por 
finalidade remover os espaços e quebras de linha existentes no fim de uma string. 
Se não utilizarmos essa função, poderão ocorrer problemas no momento de realizar 
operações aritméticas sobre o dado lido, visto que este possui caracteres que não 
deveria possuir, 


Caso o arquivo do contador ainda não tenha sido criado, atribuiremos o valor 1 à 
variável que armazena o valor atual. Em seguida, o arquivo do contador é aberto (ou 
criado) no modo de escrita e o valor atual é gravado por meio da função fwrite. 


Lembre-se de que o diretório onde o programa está sendo executado deve 
possuir permissão de escrita (isso pode ser configurado no Linux por meio do 
comando chmod). Então, bastaria colocar uma chamada para o contador nas páginas 
que desejarmos: 


include "contador. inc”; 
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Dessa forma, o arquivo contador .txt sempre irá armazenar o número total de 
acessos que determinadas páginas tiveram. Uma alternativa seria você usar arquivos- 
texto separados para contar de forma individual o número de visitas a diferentes 
páginas do site. 


Trata-se da forma mais simples de criar um contador de acessos e, por isso, não 
oferece nenhum mecanismo de controle de concorrência. Por essa razão, se seu site 
recebe uma grande quantidade de acessos simultaneamente, é recomendável imple- 
mentar controle de concorrência. Isso pode ser feito pela função do PHP chamada 
fock, que infelizmente não funciona em todos os tipos de sistemas de arquivos. 


Funções do PHP para manipulação de arquivos 


Além das funções principais que acabamos de ver, existem dezenas de funções 
adicionais para a manipulação de arquivos com o PHP A seguir, serão apresentadas 
as funções que podemos utilizar com a sintaxe e uma pequena descrição de cada 
uma delas, l 


basename 


Retorna o nome do arquivo que faz parte do caminho (path) fornecido. 
Permite especificar um sufixo a ser eliminado caso este exista no final do 
nome do arquivo. 


string basename (string caminho E, string sufixo]) 


chgrp 
Tenta alterar o grupo ao qual pertence o arquivo. 
bool chgrp (string nome arquivo, misto grupo) 
chmod 
Tenta alterar as permissões do arquivo, de acordo com o modo fornecido. 
bool chmod (string nome arquivo, int modo) 
chown 
Tenta alterar o proprietário do arquivo. 
booi chown (string nome arquivo, misto usuário) 
clearstatcache 


Limpa a memória cache que armazena informações de estado do arquivo. O 
PHP usa essa memória para melhorar o desempenho na execução de algumas 
funções, tais como stat, Istat, file exists, is writable etc. 


void clearstatcache (vazio) 
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copy 
Copia um arquivo. 


bool copy Cstring origem, string destino) 


delete 
Exclui um arquivo, assim como a função unlink. 


void delete (string arquivo) 


dirname 
Retorna o diretório que faz parte do caminho (path) fornecido. 
string dirname (string caminho) 
disk free space 
Retorna o espaço (em bytes) disponível no diretório. 
float disk free space (string diretório) 
disk total space 
Retorna o tamanho (em bytes) total de um diretório. 
float disk_total space (string diretório) 


diskfreespace 


É um apelido (alias) para a função disk free space. 


fclose 
Fecha um arquivo. 
boo! fclose (recurso ponteiro arquivo) 
feof ` 
Testa se o ponteiro já alcançou o final do arquivo. 
bool feof (recurso ponteiro arquivo) 
flush 
Força a escrita de rodos os dados de saída armazenados em buffer para um 
arquivo. 
bool fflush (recurso ponteiro arquivo) 
fgetc 


Obtém um caractere a partir da posição atual do ponteiro do arquivo. 


string fgetc (recurso ponteiro arquivo) 


110 


fgetcsy 


fgets 


fgetss 
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Lê uma linha do arquivo e analisa os campos como se estivessem no formato 


CSV. 


array fgetcsv (recurso ponteiro arquivo, int tamanho [, string delimitador 
[, string delimitador?]]) 


Lê uma linha do arquivo. 


string fgets (recurso ponteiro arquivo [, int tamanho!) 


Lê uma linha do arquivo e retira as tags HTML e PHP. 


string fgetss (recurso ponteira arquivo, int tamanho [, string tags permitidas]) 


file exists 


Testa se um arquivo ou diretório existe. 


bool File exists (string nome arquivo) 


file get contents 


Lê o conteúdo inteiro de um arquivo, retornando-o em uma string. 


string file get contents (string nome arquivo [, int usar include path [, recurso contexto] ]) 


file put contents 


Escreve uma string em um arquivo. É equivalente a chamar as funções fopen, 
fwrite e fclose sucessivamente, 


int file put contents (string nome arquivo, string dados [, int flags [, recurso contexto]]) 


file 
Lê o conteúdo inteiro de um arquivo, retornando-o em array onde cada 
elemento corresponde a uma linha do arquivo. 
array file (string nome arguivo [, int usar include path [, recurso contexto]]) 
fileatime 


Retorna a hora do último acesso ao arquivo, utilizando formato timestamp 
do Unix. 


int fileatime (string nome argtrivo) 


Capitulo 4 = Arquivos texto: praticidade e rapidez 1 


filectime 


Retorna a hora da última modificação no descritor do arquivo, utilizando 
formato timestamp do Unix. 


int filectime (string nome arquivo) 


filegroup 
Retorna o identificador do grupo ao qual pertence o arquivo. 


int filegroup (string nome arquivo) 


fileinode 
Retorna o descritor (inode) do arquivo. 


int fileinode (string nome arquivo) 


filemtime 


Retorna a hora de alteração do arquivo, utilizando formato timestamp do 
Unix. 


int filemtime (string nome arquivo) 


a 


fileowner 
Retorna o número identificador do proprietário do arquivo. 


int fileomner (string nome arquivo) 


fileperms 


Retorna as permissões de acesso do arquivo. 


int fileperms (string nome arquivo) 


filesize 
Retorna o tamanho do arquivo, em bytes. 


int Filesize (string nome arquivo) 


filetype 


Retorna o tipo do arquivo. Os valores possíveis são fifo, char, dir, block, Tink, 
file e unknown. 


string filetype (string nome arquivo) 


flock 


Bloqueia ou desbloqueia um arquivo para realizar determinadas operações. 
Fode ser usado, por exemplo, para evitar escritas concorrentes. 


bool flock (recurso ponteiro arquivo, int operação [, int &bloquear]) 


112 PHP para quem conhece PHP 


fnmatch 
Busca por um padrão em um nome de arquivo. 


array fnmatch ¿string padrão, string string E, int Flags 


fopen 


Abre um arquivo ou URL. Se for fornecido um URL, a abertura só irá 
funcionar se a diretiva allow_url_fopen estiver habilitada no php.ini. 


recurso fopen (string nome arquivo, string modo [, int usar include path 
[, recurso contexto) 


fpassthru 
Exibe os dados restantes a partir da posição atual do ponteiro do arquivo. 


int fpassthru (recurso ponteiro arquivo) 


fputs 


É um apelido (alias) para a função fwrite. 


fread 


Lê dados de um arquivo. A leitura termina quando o número de bytes 
especificado é lido ou o fim do arquivo é alcançado. 


string fread (recurso ponteiro arquivo, int tamanho) 


x 


fscanf 


Interpreta o conteúdo de um arquivo de acordo com um determinado 
formato. 


misto fscanf (recurso ponteiro arquivo, string formato [, string vari]) 


fseek 


Posiciona o ponteiro em um arquivo. A nova posição é obtida adicionando- 
se o parâmetro offset à posição especificada pelo parâmetro local, que pode 
assumir os valores SEEK SET (padrão), SEEK CUR e SEEK END. 


int fseek (recurso ponteiro arquivo, int offset [, int Tocal]) 


fstat 
Retorna informações sobre um arquivo usando um ponteiro aberto, 


array fstat (recurso ponteiro arquivo) 


ftell 
Retorna a posição atual de leitura/escrita do ponteiro do arquivo. 


int ftell {recurso ponteiro arquivo) 
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ftruncate 


Trunca um arquivo, ou seja, elimina seu conteúdo deixando-o com tamanho 
zero. 


boot ftruncate (recurso ponteiro arguivo, int tamanho) 


fwrite 
Escreve dados em um arquivo, Se for informado o parâmetro tamanho, a escrita 
irá parar após ser atingido o número de bytes especificado. 
int fwrite (recurso ponteiro arquivo, string string [, int tamanho]) 

glob 
Retorna um array contendo todos os caminhos (arquivos/diretórios) que 
satisfazem um determinado padrão. 
array glob (string padrão [, int Flags]) 

is dir 


Testa se o nome fornecido é um diretório. 
bool is dir (string nome arquivo) -> 
is executable 
Testa se um arquivo é executável. 
bool is executable (string nome arquivo) 
is file 
Testa se o nome fornecido é um arquivo válido. 
bool is file (string nome arquivo) 
is link 
Testa se o arquivo é um link simbólico. 


bool is. Jink (string nome arquivo) 


is teadable 
Testa se o arquivo pode ser lido. 


bool is readable (string nome arquivo) 


is uploaded file 


Indica se o arquivo foi enviado através de um upload via HTTP pelo método 
POST. 


bool is uploaded file (string nome arquivo) 
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is writablo 


Testa se o arquivo pode ser escrito. 


bool is writable (string nome arquivo) 


is writeable 


Apelido (alias) para a função is writable. 


link 
Cria um link físico. 
bool Tink (string alvo, string Tink) 
linkinfo 
Retorna informações sobre um link. 
int Tinkinfo (string caminho) 
istat 
Retorna informações sobre um arquivo ou um link simbólico. 
array Istat (string nome arquivo) 
mkdir 


Cria um diretório. , 


bool mkdir (string caminho [, int modol) 


move uploaded file 


Move um arquivo enviado por upload para um novo local. 


boo] move uploaded. file (string nome arquivo, string destino) 


parse ini file 


Analisa um arquivo de configuração .ini, retornando suas informações em 
um array associativo. 


array parse ini file (string nome arquivo [, bool seções processos]) 


pathinfo 


Retorna um array associativo contendo informações sobre o caminho para 
um arquivo. Os elementos retornados são dirname, basename e extension. 


array pathinfo (string caminho) 
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pelose 
Fecha o ponteiro para um processo, aberto com popen. 
int pclose (recurso ponteiro arquivo) 
popen 
Abre um ponteiro para um processo. Difere do fopen por ser unidirecional 
(usado somente para leitura ou escrita). O ponteiro pode ser usado em funções 
como fgets, fgetss e fputs. 
recurso popen (string comando, string modo) 
readíile 
Lê um arquivo e imprime seu conteúdo na saída-padrão. 
int readfile (string nome arquivo [, bool usar include path [, recurso contexto] 
readlink 
Retorna o destino de um link simbólico. 
string readlink (string caminho) 
realpath 
Retorna um caminho em sua forma canônica, expandindo links simbólicos 
e resolvendo referências como /./ eP. 
string realpath (string caminho) 
rename 
Renomeia um arquivo. 
bool rename (string nome antigo, string novo nome) 
sewind 
Retorna o ponteiro ao início do arquivo. 
bool rewind (recurso ponteiro arquivo) 
rmdir 


Exclui um diretório. 


bool rmdir (string diretório) 


set file buffer 


Apelido (alias) para a função stream set write. buffer. Permite ajustar a quantidade 
de dados a ser armazenados em buffer nas operações de escrita. 


int stream set write buffer (rescurso arquivo, int buffer) 


116 


stat 


symlink 
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Retorna um array contendo informações sobre um arquivo, como número 
do descritor (inolude), identificador do proprietário, tamanho, último acesso, 
entre outras. 


array stat (string nome arguivo) 


Cria um link simbólico. 


boot symlink (string alvo, string Fink) 


tempnam 


tmpfile 


touch 


umask 


unlink 


Cria um nome de arquivo úņico dentro do diretório especificado. 


string tempnam (string dir, string prefixo) 


Cria um arquivo temporário com um nome único, no modo de escrita. O 
arquivo é automaticamente excluído ao final da execução ou se for fechado 
de forma explícita com fclose. 


recurso tmpfile (vazio) 


Tenta configurar as horas de acesso e de modificação de um determinado 
arquivo. 


boo] touch (string nome arquivo [, int tempo [, int tempo acesso]]) 


Troca a máscara (umask) corrente e retorna a máscara antiga. 


int umask C[int maskl) 


Exclui um arquivo, Retorna TRUE, em caso de sucesso, e FALSE, se falhar. 


bool unlink (string nome arquivo) 
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À página envia o e-mail 


Neste capítulo, você aprenderá um recurso utilizado com frequência pelos desenvol- 
vedores de páginas web, que é o envio de e-mails utilizando o PHP Será explicada 
a utilidade de enviar e-mails por meio de seus programas, além de como utilizar a 
função que executa essa tarefa. Ao final do capítulo, será apresentado um exemplo 
envolvendo a coleta de sugestões dos usuários de um site e o envio dessas informa- 
ções via e-mail ao webmaster. 


Por que enviar e-mails com o PHP? 


Existem diversas situações em que o envio de e-mails pelo PHP é de grande utilida- 
de. Quando, por exemplo, um usuário preenche o formulário de cadastramento de 
um site, escolhendo um username (nome de usuário) e uma senha, é comum que o 
sistema lhe envie automaticamente um e-mail confirmando seu cadastro, enviando 
também os dados que ele forneceu no formulário. Isto é feito para que o usuário 
possa guardar essas informações, podendo recuperá-las em caso de esquecimento 
da senha ou do username. , 


Outro exemplo que pode ser citado é o de uma loja que vende seus produtos pela 
internet, em que cada pedido de compra é armazenado no banco de dados. Como a 
loja vai saber se algum cliente realizou alguma compra? Uma alternativa seria fazer 
um programa que consulte o banco de dados e mostre os pedidos ocorridos em 
determinado período de tempo. Mas nesse caso a melhor alternativa seria fazer que 
a loja recebesse um e-mail informando que houve uma compra. Esse e-mail poderia 
conter, por exemplo, nome e endereço do cliente e os produtos que ele comprou. 


Seria interessante que o cliente também recebesse um e-mail informando que 
seu pedido foi recebido, com outras instruções que ele deve seguir para receber os 
produtos comprados. Nesse caso, o programa PHP que recebe os dados do cliente 
e da compra deveria realizar três tarefas: 
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1. gravar os dados do cliente e da compra no banco de dados; 
2. enviar um e-mail para o cliente confirmando o recebimento de seu pedido; 


3. enviar um e-mail para a própria loja, notificando-a de que houve uma compra, 
para que o pedido seja processado. 


Alguns desenvolvedores, para garantir que o usuário digite o e-mail correto 
no momento do cadastro, utilizam o PHP para enviar um e-mail para o endereço 
digitado, enviando nesse e-mail uma senha especial. Então, o usuário deve acessar 
uma outra página e digitar essa senha para validar seu cadastro. 


Outra situação que pode ser citada é o envio de sugestões ou comentários pelos 
usuários de um site. Muitos sites apresentam um formulário pelo qual o usuário 
pode enviar suas opiniões. No momento em que o usuário termina de digitar e clica 
o botão Enviar, o programa PHP que recebe os dados envia dois e-mails: um para o 
próprio site, contendo os dados do formulário, e outro para o usuário, agradecendo 
e confirmando o recebimento de sua opinião. 


Enfim, essas são apenas algumas das inúmeras aplicações desse recurso que o 
PHP nos oferece. 


Quem envia o e-mail? ' 


O título desse capítulo é “A página envia o e-mail” somente para mostrar que um 
e-mail pode ser enviado através de uma página PHP. Porém, é claro que não é a 
própria página que envia o e-mail, pois esta apenas solicita o envio ao servidor 
SMTP (Simple Mail Transfer Protocol). Por essa razão, para enviar e-mails pelo PHP, 
é necessário que exista um servidor de envio de mensagens configurado, como o 
Sendmail, do Linux. 


O PHP irá primeiramente procurar pelo Sendmail nos diretórios existentes em 
seu PATH (caminho) e, logo após, nos diretórios: 


fusr/bin: /usr/sbin:/usr/etc: /etc: /usr/ucblib: /usr/Tib 


Os desenvolvedores do PHP recomendam que o Sendmail possa ser acessado 
através do PATH de seu sistema. 


Se o sistema operacional utilizado for o Windows, provavelmente a função mail 
não funcionará, a não ser que você possua um programa próprio de SMTP instalado 
e configurado corretamente no arquivo php. ini (veja o tópico sobre as diretivas de 
configuração neste capítulo). 
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Outra alternativa seria utilizar uma classe PHP externa para o envio de e-mails, 
como, por exemplo, a PHPMailer, disponível em http: //phpmailer. sourceforge.net/, Essa 
classe permite configurar inclusive servidores SMTP que requerem autenticação. 


Utilizando a função mail 


A função mail é a única responsável pelo envio de e-mails por programas PHP Sua 
sintaxe é a seguinte: 


bool mail (string destinatário, string assunto, string mensagem 
[, string cabeçalhos. adicionais [, string parâmetros adicionais]]) 


Essa função envia automaticamente um e-mail para o endereço especificado em 
destinatário, contendo o texto especificado em mensagem, O título do e-mail deve ser 
especificado em assunto. As informações mostradas entre colchetes são opcionais. 


Veja um simples exemplo de uso da função mail: 


mail ("joaoQdominio. com.br", "Bem-vindo", "Olá JoaoinSeja bem-vindo! "9; 


Podemos também enviar um e-mail para múltiplos destinatários. Para isso, 
basta separar os endereços pelo caractere ; (ponto-e-vírgula), conforme mostrado 
a seguir: 


mail ("joaoêdominio.com.br;pedrofoutrodominio. com.br”, "Teste", 
"Olá João e PedrolnIsto é um teste"): 


O caractere especial n representa uma quebra de linha. É o equivalente a apertar 
a tecla ENTER nos editores de texto. Portanto, quando esse comando for executado, 
será enviado um e-mail com o título “Teste” para os dois endereços especificados no 
primeiro parâmetro da função, e esse e-mail conterá a seguinte mensagem: 


Olá João e Pedro! 
Isto é um teste 


Diretivas de configuração no php.ini 


O arquivo de configuração php. ini possui algumas diretivas de configuração que 
estão relacionadas com o envio de e-mails pelo PHP A seguir, serão apresentadas 
essas diretivas, com uma descrição de cada uma delas. 
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Diretiva 
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Descrição 


SMTP 


smtp_port 


sendmail_from 


sendmail_path 


Usado somente no Windows. Contém o nome ou o IP do servidor 
SMTP que o PHP deve utilizar para enviar e-mails com a função 
mail. pão padrão é localhost. 


Usado somente no Windows. Disponível desde o PHP 430, contém 
o número da porta na qual deve ser feita a conexão com o servidor 
especificado na diretiva SMTP. O padrão é a porta 25, 


Endereço de e-mail que deve ser usado no campo do remetente 
(From:”) nos e-mails enviados pelo PHP no Windows. O padrão 
é NULL. 


Indica onde o programa do sendmail pode ser encontrado no 
sistema. Normalmente contém o valor /usr/sbin/sendmail ou / 
usr/Vib/sendmail, Para sistemas que não utilizam o Sendmail, essa 
diretiva deve ser configurada de acordo com o software utilizado. 
Por exemplo, usuários do Qmail podem alterar essa diretiva para 
fvar/qmail/bin/sendmail ou /var/qmail/bi n/gmail-inject. 


Composição de uma mensagem 


Para melhorar a legibilidade do código, você pode utilizar uma variável do PHP eo 


operador de concatenação (.=) para compor a mensagem do e-mail, que posterior- 
mente será passada como parâmetro à função mail. Como exemplo de composição 
de uma mensagem e envio desta por e-mail, observe o programa a seguir: 


mensagem.php 


<?php 
$mensagem = "Seja bet vindo ao site da Novatec Editora! nin"; 
$mensagem .= "Aqui você encontra as melhores publicações de Informática. "; 
frensagem .= "Confira nossa série Guia de Consulta Rápida e cadastre-se para "; 
mensagem .= "receber as novidades do site periodicamente.Anº: 
$mensagem .= "Qualquer dúvida, entre em contato conosco ": 
mensagem .= "pelo e-mail Teitorênovatec. com.brimn": 


mail (CusuarioQdominio. com.br", "Mensagem de boas vindas", $mensagem); 


?> 


Esse programa envia uma mensagem de boas-vindas a um usuário que supos- 
tamente tenha se cadastrado no site da Novatec Editora. Note que nesse código a 


mensagem é estática, ou seja, será enviado sempre o mesmo texto para todos os 
usuários que se cadastrarem. Porém, essa mensagem poderia ser personalizada, 
bastando acrescentar variáveis do PHP à mensagem, como, por exemplo, o nome 


do usuário: 


$mensagem = “Olá $nome! Seja bem vindo ao site da Novatec Editora!"; 
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Mais adiante, veremos um exemplo de composição de mensagem utilizando o 
valor de campos recebidos de um formulário HTML. 


Adicionando informações ao cabeçalho do e-mail 


A função mail ainda possui um quarto e um quinto parâmetros, que são opcionais. 
Se o quarto parâmetro for passado, será acrescentado ao final do cabeçalho do 
e-mail. 


Esse parâmetro é utilizado para enviar informações extras ao servidor que recebe- 
rá a mensagem. Nele, podemos incluir uma ou mais informações extras, separando-as 
por uma quebra de linha (caractere \n). Veja um exemplo simples: 


from.php 


<?php 
$remetente = "webmasterĝalgumdominio. com.br"; 
Sdestinatario = "alguemādominio. com. br"; 
$mensagem = “Isto é um teste!": a 


mail($destinatario, "Teste", $mensagem, "From: $remetente"); 
?> 


Esse comando envia, no quarto parâmetro, a informação From, que indica ao 
servidor que receberá a mensagem qual o endereço eletrônico do remetente. O 
envio do cabeçalho From é importante para evitar que apareça o nome do servidor 
como remetente da mensagem. Agora observe o comando a seguir, que envia mais 
de uma informação no quarto parâmetro da função mail: 


mail("alguemêdominio.com”, "Teste", $mensagem, "From: 
webmasterâdominio. cominReply-To: infofidominio. com"); 


` 


A informação Reply-To indica para qual endereço eletrônico deve ser enviada a 
resposta a esse e-mail, Portanto, quando o destinatário receber o e-mail em seu 
programa de correio eletrônico, ao clicar “Responder”, nem sempre a resposta será 
enviada para o remetente da mensagem. A resposta será enviada para o endereço 
especificado na opção Reply-To. Veremos no final deste capítulo outras informações 
extras que podemos enviar. 


Apenas para seu conhecimento, existe ainda um quinto parâmetro da função 
mail, que foi adicionado à versão 40.5 do PHP. Com esse parâmetro, podemos enviar 
informações extras à chamada do programa que envia os e-mails. Essas informações 
são as mesmas que poderíamos passar se o programa fosse chamado pela linha de 
comando do sistema operacional, 
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Enviando e-mails em formato HTML 


O envio de e-mails em formato HTML está sendo cada vez mais utilizado por 
diversos sites que necessitam dos recursos de correio eletrônico. Em vez de enviar 
um e-mail em formato texto, sem cores, figuras ou qualquer outra formatação, os 
desenvolvedores estão optando por enviar e-mails com todos os recursos que o 
HTML oferece. 


Muitos sites costumam enviar um clipping (informativo sobre as novidades da 
semana, por exemplo) a seus usuários. Com certeza será muito mais atrativo se os usu- 
ários receberem um e-mail colorido e com imagens que um e-mail com texto puro. 


Provavelmente muitos deles nem sequer leriam um e-mail que possuísse uma 
enorme quantidade de texto sem formatação alguma. 


No entanto, o formato texto é o padrão para o envio de e-mails por meio da função 
mail do PHP. Se tentarmos simplesmente colocar tags HTML em uma mensagem 
e enviá-la a algum e-mail, essas tags não serão reconhecidas pelo gerenciador de 
e-mails do destinatário. Veja o seguinte exemplo: 

<?php 

$mensagem = "<font color=)"H0000FFN">Teste</font>"; 


mait("joaoQdominio. com.br”, "Teste", $mensagem); 
?> 


» 


O objetivo seria enviar um e-mail escrito “Teste” em letras azuis, porém o dono 
do endereço joaoftdominio. com.br receberá um e-mail escrito: 


<font color="H40000FF">Teste</font> 


Portanto, para enviar e-mails em formato HTML, não basta simplesmente co- 
locar as tags. Além de colocá-las na mensagem, devemos informar o tipo de e-mail 
que está sendo enviado. Isso é feito por meio do quarto parâmetro da função mail, 
com o uso da opção Content-Type. Essa opção deve conter o valor “text/html” quando 
quisermos enviar e-mails em formato HTML. Veja o exemplo: 


formato. html.php4 


<?php 
Sdestinatario = "joaoâdominio. com.br"; 
$mensagem = "<font color=\"#0000FF\">Teste</font>"; 
mail($destinatario, "Teste", $mensagem, "Content-Type: text/html"); 
?> 


Por meio do quarto parâmetro da função mail foi enviada uma informação extra 
(Content-Type) dizendo que esse e-mail contém texto e tags HTML. Quando o des- 
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tinatário receber esse e-mail, essa informação será analisada por seu gerenciador, 
que fará a leitura adequada. 


Para evitar a tarefa de ter de digitar os comandos HTML, é possível utilizar 
um editor de páginas, como, por exemplo, o Frontpage ou o Dreamweaver. Após 
construir a página, basta copiar o código HTML que o editor gerou e trazê-lo para 
o programa PHP, atribuindo-o para a variável que deverá conter o conteúdo do 
e-mail a ser enviado. 


É importante lembrar que nem todos os programas gerenciadores de e-mails 
lêem em formato HTML. Muitas pessoas podem utilizar um gerenciador que só lê 
em formato-texto e, dessa forma, elas verão o texto em códigos, mesmo que a opção 
Content-Type contenha o valor text/html, 


Exemplos de envio de e-mails com o PHP 


Veremos agora dois exemplos de aplicações que podemos implementar utilizando 
o recurso de envio de e-mails do PHP. 


* 


Coletando as sugestões de seus visitantes 


Esse exemplo consiste em um programa que recebe as sugestões dos usuários de 
um site, encaminhando-as ao e-mail do webmaster. 


Para isso, será necessária a definição de duas páginas: 


Página Descrição 


sugestoes.html Página contendo o formulário HTMLno qual o usuário irá fornecer 
sua sugestão e sua avaliação do site. 


sugestoes.php Programa PHP queirá receber as informações do formulário, colocá- 
las em forma de uma mensagem de e-mail e enviá-las ao endereço 
eletrônico do webmaster, 


O formulário de entrada de dados 


A página sugestoes. htm] deverá conter um formulário com os campos necessários para 
obtermos a avaliação e sugestões dos usuários. Nesse formulário serão solicitadas 
as seguintes informações: 


“ nome do usuário; 


«~ e-mail do usuário; 
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" opinião do usuário sobre o site (ótimo, bom, ruim ou péssimo); 
" sugestões. 
A figura 5.1 mostra como ficaria essa página para a entrada de dados. 


O formulário será formado por dois campos de texto comum (nome e e-mail), 
quatro botões do tipo radio (para avaliação do site) e uma caixa de texto com rola- 
gem (sugestões). Conforme se explicou anteriormente, os dados desse formulário 
devem ser enviados a um programa chamado sugestoes. php, que será apresentado no 
próximo tópico. Veja a seguir como ficará o código dessa página HTML. 


| Envie suas sugestões! 


Seu nome: | no 
À Seu e-mai | : 


4 O que você achou do site? 
1 C Ótimo 

” Bom 

É Ruim 

É Péssimo 


4 Escreva no espaço abaixo as suas sugestões: 


dBi candido TEUS 
Figura 5.1 — Formulário para o envio de sugestões. 


Em sugestoes. html 


<html> 

<head> 

«title>Sugestões</title> 

</head> 

<body> 

<hl>Envie suas sugestões! </hi> 

<form method="POST" action="sugestoes. php"> 
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<p>5eu nome: <input type="text” name="nome” size="20"></p> 
<p>Seu e-mail: <input type="text” name="email" size="20"></p> 
<p>0 que você achou do site?<br> 
<input type="radio" value="otimo” name="avaliacao">Ótimo<br> 
<input type="radio" value="bom” name="avaliacao">Bom<br> 
<input type="radio" value="ruim” name="avaliacao">Ruim<br> 
<input type="radio" value="pessimo" name="avaliacao">Péssimo</p> 
<p>Escreva no espaço abaixo as suas sugestões: <br> 
«<textarea rows="6" name="sugestoes” cols="43"></textarea></p> 
<p><input type="submit" value="Enviar" name="enviar"></p> 

</form> 

</body> 

</html> 


Enviando por e-mail os dados recebidos 


Agora basta criarmos o programa sugestoes .php, que irá receber os dados desse 
formulário e enviá-los por e-mail ao webmaster do site. O endereço para o qual a 
mensagem será enviada ficará armazenado na variável email destino. Altere o valor 
dessa variável, colocando o e-mail desejado. 


Acompanhe, então, o código do programa sugestoes.php apresentado a seguir. 
Note que, antes de realizar o envio do e-mail, devemos obter os dados do formulá- 
rio acessando o array superglobal 5. Post. Se algum dos elementos desse array não 
estiver definido, será exibida uma mensagem de erro. 


sugestoes.php 


<?php 
Semail destino = "webmasterfâseusite. com.br”; 


if Cisset(£ POST['nome'3) && isset(S POSTI'email']) && isset(S. POSTO 'avaliação!]) && 
isset (5. POSTL' sugestoes '1)) 
{ 


$nome = $_POST['nome'"]; 

$email = $ POST/ email"); 
favaliacao = & POST/ avaliacao"); 
$sugestoes = $ POST[ 'sugestoes 1; 


} 

else 

{ 
echo "Todos os campos devem ser preenchidos!"; 
exit; 

: 


fmensagem = "Nome do usuário: $nome\n"; 


$mensagem .= "E-mail: Semaihn”; 
$mensagem .= "Avaliação: Savaliacaon”; 
$mensagem .= "Sugestões: Ssugestoes”; 


mail(Semail destino, "Sugestão de usuário”, $mensagem); 
echo "Sua mensagem foi enviada com sucesso! "; 
7> 
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Veja que foram feitas várias concatenações à variável mensagem para compor a 
mensagem utilizando as informações fornecidas pelo usuário. Caso deseje, poderá 
utilizar os conhecimentos adquiridos no Capítulo 2 sobre processamento de for- 
mulários, para aplicar uma validação adequada sobre cada um dos campos antes 
de enviar o e-mail, 


Mensagens para diferentes áreas da empresa 


Outro exemplo que veremos consiste em um programa que recebe mensagens dos 
usuários de um site e as encaminha para diferentes endereços eletrônicos, de acordo 
com o assunto da mensagem. É bastante comum encontrar esse tipo de programa em 
empresas onde cada área é responsável por atender aos assuntos referentes a ela. 


Por exemplo, mensagens relatando problemas no site devem ser encaminhadas 
ao webmaster, mensagens solicitando informações sobre publicidade devem ser 
enviadas ao setor comercial, e assim por diante. Para executarmos essa tarefa de 
recebimento e distribuição correta das mensagens, será necessária a definição de 
duas páginas: 


Página Descrição 


contato. htm] Página contendo o formulário HTML no qual o usuário irá forne- 
cer seus dados (nome e e-mail), digitar sua mensagem e escolher o 
assunto ao qual esta se refere. 


contato.php Programa PHP que irá receber as informações do formulário, colocá- 
las em forma de uma mensagem e enviá-las ao endereço eletrônico 
adequado, de acordo com o assunto da mensagem. 


Definindo o formulário 


A página contato.html irá conter um formulário HTML, onde serão solicitadas as 
seguintes informações: 


“ nome do usuário; 
€ e-mail do usuário; 


“ assunto da mensagem, por meio do qual iremos definir o endereço eletrônico 


3 


destino. Vamos supor que os assuntos possíveis são: “Pergunta” “Reclamação” 
“Suporte” “Publicidade” ou “Webmaster”; 


* texto da mensagem. 


À figura 5.2 mostra como ficará essa página para a entrada de dados. 


ce e AE cen aa to a 
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O formulário será formado por dois campos de texto comum (nome e e-mail), 
uma lista de seleção para escolha do assunto e uma caixa de texto com rolagem para a 
digitação da mensagem. Conforme se explicou anteriormente, os dados desse formu- 
lário devem ser enviados a um programa chamado contato. php, que será apresentado 
no próximo tópico. Veja a seguir como ficará o código dessa página HTML. 


3 Conlato - sofl intanet É 


A Endsega [E] tp ocalhosl/emadi contatar cremes 


Entre em contato conosco 


Saunome | . 
Seu e-mail] 


À Escolha o assunto de sua mensagem. 
d [Pergunta  & 


À Escreva sua mensapem no espaço abaxo. 


Figura 5.2 — Formulário para envio de mensagens pelos usuários. 


contato.himl 


<html> 
<head> 
«title>Contato</title> 
</head> 
<body> 
<hl>Entre em contato conosco</hl> 
<form method="POST" action="contato, php"> 
<p>Seu nome: <input type="text” name="nome” size="20"></p> 
<p>Seu e-mail: <input type="text" name="emai]l" size="20"></p> 
<p>Escolha o assunto de sua mensagem: <br> 
<select size="1" name="assunto"> 
<option value="pergunta">Pergunta</option> 
<option value="reciamacao">Reclamação</option> 
<option value="suporte">Suporte</option> 
<option value="pubticidade">Publicidade</option> 
<option value="webmaster">Webmaster</option> 
<fselect></p> 
<p>Escreva sua mensagem no espaço abaixo: <br> 
<textarea rows="6" name="mensagem” cols="43"></textarea»</p> 
<p><input type="submit" value="Enviar" name="enviar"></p> 
</form> 
</body> 
</html> 
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Enviando o e-mail para o endereço adequado 


O próximo passo é criar programa contato.php, que irá receber os dados desse for- 
mulário e enviá-los para o endereço eletrônico adequado, de acordo com o assunto 
da mensagem. Os endereços para os quais as mensagens serão enviadas ficarão 
armazenados em um array associativo chamado Semail. destino, onde o assunto será 
utilizado como chave. Você pode alterar à vontade os elementos desse array, colo- 
cando as chaves e valores desejados. 


Acompanhe, então, o código do programa contato. php apresentado a seguir. Note 
que, antes de realizar o envio do e-mail, devemos obter os dados do formulário 
acessando o array superglobal $. POST. Se algum dos elementos desse array não estiver 
definido, será exibida uma mensagem de erro. 


contato.php 


<?php 
femail destino = array( 
“pergunta” => "perguntasfiseusite. com.br", 
“rectamacao” => "reclamacoesQseusite, com.br”, 
“suporte” => "suportefseusite. com.br”, 
“publicidade” => "anunciosAseusite. com.br", 
"webmaster" => "webmasterâseusite. com.br” 
); 
if Cisset(3 POSTI'nome']) && isset(f POSTE 'email!]) && isset(4 POSTL assunto!) 
&& isset($ POSTE 'mensagem'])) 


{ 
gnome = $ POSTE 'nome'T; 
$email = 4 POST['email']; 
$assunto = 4 POST(assunta']: 
fmensagem = $. POSTL'mensagem']; 
} 
else 
{ 
echo "Todos os campos devem ser preenchidos!"; 
exit; 
} 


$msg = "Nome do usuário: $nomein”; 

$msg .= "E-mail: $emaitin"; 

$msg .= "Mensagem: $mensagem"; 
mail($erail_destino[$assunto], "Mensagem do usuário", $msg); 
echo "Sua mensagem foi enviada com sucesso! "; 

7> 
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Veja que foram feitas várias concatenações à variável $msg para compor a men- 
sagem utilizando as informações fornecidas pelo usuário. No momento do envio 
do e-mail, o valor do campo “assunto” foi usado como chave para obter o e-mail do 
destinatário no array $email destino: 


Semail destino[Sassunto] 


Portanto, se você alterar a lista de seleção de assuntos na página contato.html, não 
se esqueça de fazer as respectivas alterações no array Semail. destino, caso contrário 
o programa poderá não encontrar o e-mail correspondente. Caso deseje, nesse 
exemplo será possível também utilizar os conhecimentos adquiridos no Capítulo 
2, para aplicar uma validação adequada sobre cada um dos campos antes de enviar 
o e-mail. 


Lista dos cabeçalhos de e-mail (mail headers) 


Veremos agora uma lista das informações extras que podem ser enviadas em um e- 
mail. Essas informações são conhecidas como mail headers (cabeçalhos de e-mail). 
Logo em seguida temos a descrição dás principais delas. 


Header Descrição 


Bcc É uma abreviatura para Blind Carbon Copy. É utilizado 
para enviar cópias da mensagem para outros endereços, 
sem que os destinatários conheçam os endereços para 
os quais a mensagem foi enviada. Quando utilizado, o 
Bcc não aparece no cabeçalho do e-mail recebido pelo 
destinatário, 


Ce É uma abreviatura para Carbon Copy que serve para es- 
pecificarmos destinatários adicionais. Adiferença entre To 
e Cc é apenas conotativa, pois alguns programas tratam 
essas informações de maneiras diferentes no momento 
de enviar respostas. 


Comments Normalmente este header é adicionado por alguns 
programas para especificar quem enviou a mensagem. 
Algumas vezes, os spammers (aqueles que enviam e- 
mails não solicitados) o adicionam manualmente com 
informações falsas. 


Content-Transfer-Encoding É um header relacionado com MIME (Multipurpose 
Internet Mail Extentions). Define como o conteúdo da 
mensagem deve ser interpretado. Normalmente é utilizado 
para conteúdos que não são do tipo texto, 


Header 
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Descrição (cont.) 


Content-Type 


text/plain 
text/html 
application/postscript 
image/gif 
image/jpeg 
audio/basic 
video/mpeg 
x-wortd/x-vrm 

Date 


Errors-To 


From 
Message-Id 


Mime-Version 


Priority 


Received 


Reply-To 


Sender 


Subject 
To 
X-Confirm-Reading-To 


X-Mailer 


Outro header relacionado com MIME. Informa como o 
programa de e-mails deve tratar a mensagem. Veja alguns 
tipos de MIME que são aceitos: 


Documento em formato texto (ASCII). 
Documento em HTML. 
Documento PostScript. 

Imagem codificada em formato GIF. 
Imagem codificada em formato JPEG. 
Um arquivo de som. 

Um vídeo codificado em mpeg. 
Arquivo do tipo VRML. 


Data em que a mensagem foi enviada. Alguns compu- 
tadores podem ter seu relógio desconfigurado, portanto 
nem sempre podemos garantir que essa informação esteja 
correta. 


Endereço para que sejam informados os erros no envio 
da mensagem. 


Contém o endereço do remetente da mensagem. 


Identificador atribuído a uma mensagem. E-mails em que 
essa informação é vazia provavelmente foram forjados. 


Especifica a versão do protocolo MIME que está sendo 
utilizada pelo programa de e-mails. 


Atribui uma prioridade a um e-mail, Alguns spammers 
enviam e-mails com prioridade “Urgente” para tentar 
fazer que seus e-mails sejam lidos. Muitos programas 
gerenciadores de e-mails não lêem esse tipo de header, 


Fornece um log detalhado do histórico da mensagem, 
tornando possível o conhecimento de sua origem. 


Endereço para o qual a mensagem deve ser respondida. 
Quando a pessoa clicar “Responder” em seu gerenciador 
de e-mails, a resposta será enviada para o e-mail especi- 
ficado nesse header. 


Este header é pouco comum em um e-mail. Normalmente 
X-Sender é utilizado em seu lugar para especificar que 
está enviando a mensagem. O Sender é um header mais 
confiável que o From. 


Título da mensagem. 
Endereço do(s) destinatário(s) da mensagem. 


Este header solicita confirmação de recebimento por parte 
do destinatário do e-mail, porém ele pode enviar ou não 
essa confirmação. 


Identifica o software que enviou o e-mail. 


Capítulo 6 


Enviar arquivos? Faça Upload! 


Provavelmente você não ouve o termo upload com tanta frequência como o termo 
download. Ao contrário da operação de download, que consiste em “baixar” um 
arquivo de um computador remoto para seu computador local, fazer upload é exa- 
tamente o contrário. Consiste em enviar um ou mais arquivos de um computador 
local para um computador remoto. Neste capítulo, você irá aprender passo a passo 
como usar os recursos do PHP para fazer o upload de arquivos, além de saber em 
que ocasiões utilizar essa operação. 


Por que fazer upload de arquivos? 


Muitas vezes, você pode se deparar com a necessidade de descarregar arquivos em 
um computador remoto. A seguir, serão apresentadas algumas situações em que 
isso ocorre. 


* Lojavirtual: um exemplo que pode ser citado, e talvez o mais comum, é o ca- 
dastramento de produtos em uma loja virtual. Ao inserir um novo produto 
na loja, é bastante interessante haver a opção de enviar a imagem do produto 
com seus dados. Assim, qualquer cliente que acessar a loja virtual terá à dis- 
posição não só as informações detalhadas de todos os produtos, mas também 
suas fotos, o que aumentará as chances de efetivação de uma compra. 


"Sites de currículos: por exemplo, se você tiver um site que permite o cadastramento 
do currículo das pessoas, um recurso interessante a ser oferecido é o envio das 
fotos das pessoas cadastradas. Assim, ao inserir seu currículo, a pessoa teria a 
opção de “anexar” a seus dados um arquivo contendo sua foto. Esse arquivo 
ficaria armazenado em algum diretório localizado no servidor e a imagem 
seria exibida toda vez que alguém consultasse o currículo dessa pessoa. 
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= Sites de relacionamentos: são cada vez mais comuns na internet. O usuário se 
cadastra preenchendo um formulário com seus dados pessoais, preferências, 
características da pessoa que procura e, assim como em alguns sites de cur- 
rículos, é possível enviar uma foto, que poderá ser vista por todas as pessoas 
que consultarem o perfil desse usuário. 


* Compartilhamento de arquivos: criar um espaço para os usuários de um site compar- 
tilharem arquivos é bastante comum. Pode-se criar, por exemplo, um diretório 
protegido por senha, para que os usuários de uma lista de discussão possam 
depositar os arquivos que desejam compartilhar com os demais usuários. O 
envio desses arquivos pode ser feito com um simples script PHP. 


* Disco virtual: provavelmente você já deve ter ouvido falar dos discos virtuais 
oferecidos por diversos provedores de acesso do Brasil, como Terra e UOL. 
Trata-se de um espaço para você guardar seus arquivos, a fim de manter 
uma cópia on-line dos mais importantes e acessá-los em qualquer lugar e 
a qualquer momento. O disco virtual pode relacionar-se ao tópico anterior, 
visto que também pode ser usado para compartilhar arquivos com outras 
pessoas. Em ambos os casos, o envio desses arquivos para o servidor é feito 
por meio de uma operação de upload pela web. 


= Provedores de hospedagem: alguns provedores de hospedagem oferecem aos 
webmasters a opção de publicar suas páginas na internet por meio de uma 
interface web que permite a realização de uploads. Outros oferecem apenas 
o upload de arquivos com o uso de algum software de FTP (File Transfer 
Protocol). 


Diferenças entre os protocolos HTTP e FTP 


Os dois principais protocolos utilizados para realizar transferência de arquivos são 
o HTTP (Hyper Text Transfer Protocol) e o FTP (File Transfer Protocol). O envio por 
HTTP é feito através de uma página web, enquanto o por FTP ocorre por meio de 
algum software que possua as funcionalidades de um cliente de FTP 


Como veremos mais adiante, para enviar um arquivo a um programa PHP preci- 
samos definir uma página web que contenha um formulário HTML com um campo 
de entrada do tipo file, onde o usuário poderá selecionar um arquivo para envio. 
Isso significa que o arquivo chega até o programa PHP através de uma transferência 
feita sobre o protocolo HTTP. Quando o arquivo é recebido pelo programa PHP 
localizado no servidor, podemos definir seu destino de duas formas: 
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1. simplesmente o movendo para o diretório destino. Nesse caso, teríamos uma 
simples transferência por HTTP; 


2. usando as funções do PHP relativas ao protocolo FTP para conectar-se a um 
servidor FTP (que pode estar na mesma máquina) e transferir esse arquivo. 


O PHP nos disponibiliza uma série de funções para abrir uma conexão FTP de 
dentro de uma página web, requisitada via HTTP. Ou seja, dentro de nosso progra- 
ma em PHP, temos à disposição todas as funcionalidades básicas de um software 
cliente de FTP. 


Mas, afinal, qual é a diferença de utilização entre esses dois protocolos? Quando 
se deve utilizar um ou outro? Na verdade, você não terá que optar por um ou outro 
protocolo. Como o envio irá partir de uma página web, o protocolo HTTP será 
sempre usado para transferir o arquivo do computador do usuário para o servidor. 
Resta a você decidir se para mover o arquivo a seu local destino será usado ou não 
o protocolo FTE 


Utilizamos comandos FTP quando o arquivo deve ser movido para uma área 
de FTP no próprio servidor que o recebeu ou, então, para transferir esse arquivo 
para uma área de FTP localizada em outro servidor. Por exemplo, se no sistema 
operacional existir um diretório cujo proprietário (owner) é um determinado 
usuário FTP e esse diretório não tem permissão total de escrita, não adiantará 
tentar simplesmente mover o arquivo recebido para esse local, pois o PHP não terá 
permissão para isso. A única forma de gravar um arquivo nesse local é fazendo uma 
transferência via FTP, onde serão fornecidos os dados para autenticação do usuá- 
rio proprietário do diretório. Como veremos mais adiante, a não ser que seja um 
FTP anônimo, sempre deverão ser fornecidos um nome de usuário e senha como 
parâmetros de conexão. 


Neste capítulo, serão mostradas as duas formas de definir o destino de um 
arquivo recebido. Você irá aprender a enviar um arquivo pelo próprio programa 
navegador, como se fosse um simples campo de um formulário HTML, e logo após 
movê-lo para o diretório adequado. Da mesma forma, será feito posteriormente no 
uso do protocolo FTP, no qual iremos alterar os comandos utilizados para definir 
o destino do arquivo. 


Upload utilizando PHP e HTTP 


Para fazer um upload utilizando somente o protocolo HTTP, pode-se criar uma única 
página PHP responsável por toda a operação. Porém, para facilitar o entendimento, 
vamos definir três arquivos separados para realizar o processo completo: 
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Arquivo Descrição 


upload. html É a página que você deve abrir no navegador. Contém o formu- 
lário HTML a partir do qual será selecionado o arquivo a ser 
enviado ao servidor. 


executa upload.php Página PHP responsável pela operação de upload. É ativada 
pelo formulário da página upload.html, recebendo o arquivo 
especificado pelo usuário. 


config upload.inc Arquivo contendo os parâmetros de configuração a ser consi- 
derados pela página executa upload.php. 


Todos esses arquivos estão disponíveis para download no site da Novatec 
Editora, no endereço indicado no início deste livro. Para os usuários de versões 
anteriores a 40.3 do PHP, disponibilizou-se um arquivo adicional nomeado como 
executa upload ant. 4.0.3.php, pois em versões mais antigas o upload era realizado por 
meio do comando copy em vez do atual move uploaded file. 


Definindo o formulário HTML 


O primeiro passo para permitir ao usuário fazer um upload é a criação de um for- 
mulário HTML, pelo qual ele irá selecionar o arquivo a ser enviado. A linguagem 
HTML já nos disponibiliza, entre seus tipos de campos, o tipo file para o envio de 
arquivos. Veja, a seguir, o código-fonte da página upload.html, que contém o formu- 
lário de envio: É 


upload.htmi 


<html> 

<head> 

<titlesLivro de PHP - Upload de arquivo</title> 

</head> 

<body> 

<h? align="center">Upload de Arquivos</h2> 

«form method=POST action="executa upload.php" enctype=multipart/fora-data> 
<input type="hidden" name="MAX FILE SIZE” value="200000"> 

<p align=center>Arquivo: <input type="file"” name="arguivo” size="30"> 
<p align=center><input type=submit value="Enviar arquivo"> 

</form> 

</body> 

</html> 


Ao declararmos no formulário um campo de entrada (input) do tipo file, au- 
tomaticamente serão exibidos, no navegador, uma caixa de texto e um botão que, 
quando pressionado, abrirá uma janela para a seleção de um arquivo qualquer no 
computador do usuário. A figura 6.1 mostra essa página sendo exibida no programa 
navegador. 


der mano tran ana e TS e a ce A cr mea a > 


Prieina 
erre eme param era a e 


Capítulo 6 « Enviar arquivos? Faça Upload! 135 


3] Ea a squis 


El hltpc//ocelhostfuploadeupload.htrol = , . o i 


Upload de Arquivos 


Arquivo [Ciclientes qi o Próciirar.. 


CEELI 
Figura 6.1 — Selecionando um orquivo para upload. 


Agora veremos uma rápida explicação sobre as três principais linhas do arquivo 
upload.html, A primeira é a linha onde o formulário é definido: 


<form method=POST action="executa upload.php” enctype=multipart/form-data> 


Na opção action da tag form, especifica-se o nome do programa PHP que será 
ativado pelo formulário quando o usuário clicar o botão de envio. Para indicar que 
irá ocorrer o upload de um arquivo para o servidor, deve-se utilizar a opção enctype 
com o valor multipart/form-data. 


Observe agora a linha seguinte: 


<input type="hidden" name="MAX FILE SIZE" value="200000"> 


Em operações de upload, o parâmetro MAX-FILE SIZE é utilizado pelo programa na- 
vegador para definir um tamanho máximo (em bytes) para o arquivo a ser enviado. 


Dessa forma, pode-se prevenir que o usuário selecione um arquivo muito grande 
e consuma muitos recursos do servidor. Essa é uma validação feita no lado cliente, 
ou seja, o envio do arquivo ao servidor só ocorrerá se seu tamanho for inferior ou 
igual ao valor do parâmetro MAX FILE. SIZE (em nosso exemplo, inferior ou igual a 
200000 bytes). 


Como veremos mais adiante, essa validação também pode ser feita no lado do 
servidor. Porém, para validar o tamanho do arquivo no servidor, ele deve primeiro 
chegar até lá. Por exemplo, se o tamanho limite for 200000 bytes e o usuário escolher 
um arquivo de 300000 bytes, esse arquivo será primeiramente transferido para o 
servidor, para somente depois o programa detectar que seu tamanho é inválido. 
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De qualquer forma, é bom que sejam feitas as duas validações, isto é, tanto no 
lado do cliente como no lado do servidor. Assim, você estará protegido caso algum 
usuário tente burlar o formulário HTML aumentando o valor ou removendo o 
parâmetro de limitação de tamanho. Por fim, observe a próxima linha: 


<p align=center>Arquivo: <input type="file” name="arquivo” size="30"> 


Nessa linha é definido o campo de entrada do tipo file, que irá possibilitar ao 
usuário a seleção de um arquivo qualquer. 


Parâmetros de configuração do upload 


Antes de começar o upload de seus arquivos, você pode configurar suas preferências 
em um arquivo que nomeamos como config upload.inc. Trata-se basicamente de um 
arquivo PHP contendo algumas variáveis que serão utilizadas pelo programa que 
executa o upload. Utilizou-se a extensão . inc apenas para indicar que esse arquivo 
será incluído em outra página, porém você pode alterá-la caso deseje. Acompanhe 
a seguir o código-fonte e logo após uma explicação sobre cada uma das variáveis: 


config. upload.inc 


<?php 

/f parâmetros de configuração da operação 

ff Vimitar as extensões? (sim ou nao) 

Elinitar ext = "sim"; 

ff extensões autorizadas 

fextensoes validas = array" .gif",".jpa"," .jpeg",".bmp"); 
/! caminho absoluto onde os arquivos serão armazenados 
fcaminho absoluto = "c:tapachelupload": 


ff imitar o tamanho do arquivo? (sim ou nao) 
$limitar tamanho = "nao"; 

// tamanho limite do arquivo em bytes 
Stamanho bytes = "200000"; 


/f se já existir o arquivo, indica se ele deve ser sobrescrito (sim ou nao) 
fsobrescrever = "nao"; 
?> 


A maioria dos parâmetros trata basicamente das restrições a ser impostas para 
a execução de uma operação de upload. A seguir será apresentada uma descrição 
de cada um deles. 


Parâmetro Descrição 


Slinitar ext Pode conter os valores “sim” ou “nao” Indica se deve ou não ser 
consultado o array com as extensões válidas para verificação do 
tipo de arquivo que está sendo enviado. 
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Parâmetro 


Descrição (cont.) 


Sextensoes validas 


fcaminho absoluto 


&limitar tamanho 


$tamanho bytes 


fsobrescrever 


Array contendo as extensões de arquivo que serão aceitas pelo 
servidor, Esse array é consultado somente quando o valor da 
variável $limitar ext for igual a “sim” Nesse caso, se a extensão 
do arquivo que está sendo enviado não estiver contida no array, 
o upload será abortado e uma mensagem de erro será exibida. 


Define o diretório onde serão gravados os arquivos enviados 
pelo usuário, Altere o valor dessa variável colocando o cami- 
nho completo do diretório destino e certifique-se de que esse 
diretório tem permissão de escrita. Por exemplo, no Linux, 
deve-se dar permissão de escrita ao diretório digitando chmod 
777 diretorio, através da linha de comando. Em nosso exemplo, 
utilizou-se o valor “c:+apachelupload” pois o programa foi testado 
nesse diretório em ambiente Windows. 


Pode conter os valores “sim” ou “nao” Indica se deve ou não ser 
consultada a variável $tamanho. bytes para limitar o tamanho do 
arquivo que está sendo enviado. 


Consultada apenas quando o valor da variável $limitar tamanho 
for igual a “sim”. Nesse caso, se o tamanho do arquivo que está 
sendo enviado for maior do que o valor definido nessa variável, 
o upload será abortado e uma mensagem de erro será exibida. 


Pode conter os valores “sim” ou “nao” Indica o que deve ser feito 
quando já existir um arquivo destino com o mesmo nome do 
que está sendo enviado. Se for definido o valor “sir”, o arquivo 
destino será sobrescrito, caso contrário será exibida uma men- 
sagem informando que já existe um arquivo de mesmo nome. 


Recebendo e gravando o arquivo 


A seguir será apresentado o programa responsável pela conclusão da operação de 
upload. Esse programa recebe o arquivo enviado pelo formulário da página upload. html, 
faz as devidas consistências e grava o arquivo no local destino. Acompanhe o código- 


fonte e logo após leia as explicações sobre os principais trechos do programa: 


executa upload.php 


<html> 
<head> 


<title>Livro de PHP - Upload de arquivo</title> 


</head> 
<body> 


<h2 align="center">Upload de Arquivos</h2> 


<? 
set.time limit (0); 


include 'config upload. inc'; 
nome arquivo = $_FILES arquivo']['name']; 
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$tamanho arquivo = $ FILES['arquivo Jl'size']: 
Sarguivo temporario = $ FILES["arquivo'JL'tmp name"; 
if Clempty (Snome arquivo)) 


{ 
if ($sobrescrever == "nao" && filecexists("Scaminho absoluto/fnome arquivo")) 
die("Arquivo já existe."); 
if CCSlimitar tamanho == "sim") && (ftamanho arquivo > Stamanho bytes)) 
die("Arquivo deve ter no máximo $tamanho bytes bytes. "); 
fext = strrchr(Snome arquivo, '.: 
if CGlimitar ext == "sim" && lin array(Sext, Sextensoes validas)) 
die(“Extensão de arquivo inválida para upload."): 
if (move uploaded file(Sarquivo. temporario, “Scaminho absoluto/Snome arquivo")) 
{ 
echo “<p align=center>0 upload do arquivo <b>". $nome_arquivo." 
</b> foi concluído com sucesso, </p>"; 
echo "<p align=center><a href=upload.htmi>Novo upload</as</p>": 
} 
alse 
echo “<p align=center>0 arquivo não pode ser copiado para o servidor.</p>"; 
} 
else 
die("Selecione o arquivo a ser enviado"): 
?> 
</body> 
</html> 


Vamos analisar agora os principais trechos do código. No início, o comando 
set_time_limit (0) foi utilizado para eliminar o limite de tempo de execução do 
programa. Se esse comando não for utilizado, será considerado o valor-padrão (30 
segundos) ou, então, se existir, o valor do parâmetro max execution time do arquivo 
de configuração php. ini. Se o arquivo a ser transferido for um pouco grande e seu 
tempo de transferência ultrapassar esse valor, o upload não ocorrerá com sucesso, 
daí a importância da eliminação do limite. 


Logo após foi utilizado o comando include para incluir o arquivo que contém as 
variáveis de configuração da operação. Isso foi feito por meio da seguinte linha: 


include "config upload. inc"; 


Nas três linhas seguintes, obtemos as informações sobre o arquivo que foi enviado 
pelo usuário. São elas: 


$nome arquivo = $ FILES['arquivo']U'name']; 
$tamanho arquivo = $ FILES['arquivo'J['size']; 
Sarquivo. temporario = $ FILES['arquivo']['tmp name']; 


Nessas três linhas, obtemos primeiro o nome do arquivo exatamente como está 
na máquina do usuário, depois o tamanho desse arquivo e, por último, o nome 
temporário que o servidor utilizou para armazenar o arquivo. 


arant rip ts rm 
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O modo de acessar as informações sobre um arquivo recebido varia de acordo 
com a configuração e a versão do PHP utilizada. Veja que, no exemplo apresentado, 
se utilizou o array superglobal (disponível em todo o escopo do programa) $_FILES, 
que existe desde o PHP 4.10. Poderia ser usado também o array $HTTP POST. FILES, que 
existe desde a versão 4,00; porém é preferível usar o $ FILES. Note que esse array tem 
duas dimensões. A primeira é o identificador do arquivo, isto é, o nome do campo 
do tipo file definido no formulário HTML. A segunda dimensão é o nome da pro- 
priedade cujo valor desejamos obter. No nosso exemplo, teríamos à disposição os 
seguintes elementos: 


Elemento Descrição 


$ FILES[ arquivo") [ 'name'] O nome original do arquivo no computador do usuário. 


$ FILES arquivo] [type Se existir, contém o tipo MIME (Multipurpose Internet 
Mail Extensions) do arquivo. Por exemplo, para uma 
imagem GIF, teríamos o valor image/gif. 


$& FILES[*arquivo']['size'] O tamanho do arquivo em bytes. 


SFILEST'arquivo1[ "tmp name") Nome temporário queo servidor utilizou para armazenar 
p q P 
o arquivo. 


$_FILES{'arquivo']['error'] Armazena o código do erro em caso de falha na operação 
de upload do arquivo. Esse elemento foi adicionado à 
versão 4.20 do PHP 


Caso você não queira utilizar o array $_FILES nem o $HTTP. POST. FILES (que ainda 
existe, mas está em decadência), há ainda uma terceira opção de acesso a essas 
informações. Caso a opção register globals do arquivo de configuração php. ini es- 
teja habilitada (valor "on"), serão automaticamente criadas variáveis compostas da 
seguinte forma: 


identificador do arquivo + _ + nome da propriedade 


Ou seja, em vez de acessar o elemento $ FILES['arquivo']L'name'], acessaríamos 
uma variável chamada Sarquivo name, em vez de $ FILES['arquivo']['size'], teríamos 
farquivo. size, e assim por diante. A única variável que não seguiria essa regra seria 
a $ FILES "arquivo" ]['tmp name'], pois seu valor estaria armazenado no próprio con- 
teúdo da variável Sarquivo, Portanto, caso opte por utilizar essa forma, poderíamos 
substituir as três linhas do código em questão por: 


fnome arquivo = farquivo name; 
$tamanho arquivo = Sarquivo size; 
farquivo temporario = Sarquivo; 


É importante lembrar que, no arquivo de configuração do PHP o valor-padrão 
da opção register_globals é “Off” desde o PHP 4,20. 
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Prosseguindo com a análise do código do programa executa upload.php, após a 
obtenção das informações sobre o arquivo, iniciam-se as consistências baseadas nas 
variáveis definidas em nosso arquivo de configuração config upload. inc. A primeira 
é a seguinte: 


if ($sobrescrever == "nao" && file exists("$caminho, absoluto/fnome arquivo") 


Se você definir o valor “nao” para a variável Ssobrescrever, O script irá prosseguir 
somente se não existir um arquivo com mesmo nome no local destino, caso con- 
trário será exibida uma mensagem de erro. Logo após temos a consistência relativa 
ao tamanho do arquivo: 


if (CSlimitar. tamanho == "sim") && ($tamanho arquivo > $tamanho bytes)) 


Lembre-se da importância de fazer essa consistência de tamanho no lado do 
servidor, visto que é fácil de enganar o parâmetro MAX FILE SIZE do formulário HTML 
do cliente. A próxima validação é referente à extensão do arquivo que está sendo 
enviado: 


$ext = strrchr(fnome arquivo, '.); 
if CSlimitar ext == "sim" && lin array(Sext, fextensoes validas)) 


Utilizamos a função strrchr para retornar a porção do nome do arquivo que se 
inicia no ponto e vai até seu final, ou seja, o ponto mais sua extensão. Logo após, 
usamos a função in array para verificar se algum elemento do array Sextensoes vali- 
das contém esse valor. Se não contiver e o parâmetro $limitar. ext estiver habilitado 
(valor “sim”), o upload não será aceito, por não se tratar de um tipo de arquivo 
permitido. 


Caso todas as condições sejam satisfeitas, o arquivo enviado será movido do 
diretório temporário utilizado pelo servidor para seu destino: 


move uploaded fileCSarquivo temporario, "$caminho absoluto/fnome arquivo") 


Se você estiver usando uma versão anterior ao PHP 403, o comando move uplo- 
aded file não será reconhecido, e você deverá substituí-lo pelo comando copy, como 
mostra a linha a seguir; 


copy(Sarquivo temporario, “$caminho absoluto/fnome arquivo"); 


Caso ocorra algum erro na tentativa de mover o arquivo, será exibida a mensagem 
informando que o arquivo não pôde ser copiado para o servidor. Um exemplo de 
erro que ocorre com fregiiência é o de quando o sistema operacional não consegue 
gravar o arquivo no local destino devido à ausência de permissão de escrita no 
diretório. Se não ocorrer erro algum, o upload será concluído e será exibida uma 
mensagem indicando operação bem-sucedida, como mostra a figura 6.2. 
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É) tp: /Mocalhost 


Upload de Arquivos 


O upload do arquivo chentes.gif foi concluído com sucesso. 


Novo upload 


Figura 6.2 — Mensagem exibida ao final da operação. 


Upload utilizando PHP e FTP 


Veremos agora como realizar um upload utilizando as funções que o PHP oferece 
para uso do protocolo de transferência FTP. Assim como foi feito no upload simples 
via HTTP, aqui também vamos definir três arquivos que irão realizar o processo 
completo. São eles: 


Arquivo Descrição 


upload ftp.html Éa página que você deve abrir no programa navegador. Con- 
tém o formulário HTML, a partir do qual será selecionado 
o arquivo a ser enviado ao servidor. 


executa upload ftp.php Página PHP responsável pela operação de upload. É ativada 
pelo formulário da página upload ftp.html, recebendo o 
arquivo especificado pelo usuário. 


config upload ftp.inc Arquivo contendo os parâmetros de configuração do servidor 
e do upload, que serão utilizados pela página executa upload. 
ftp.php. 


Definindo o formulário HTML 


Assim como no upload simples via HTTP, a primeira tarefa a ser realizada é criar 
um formulário HTML pelo qual o usuário irá selecionar o arquivo a ser enviado. 
Deve-se utilizar um campo de entrada (input) do tipo file. O código desse formulário 
é quase idêntico ao do formulário criado para o upload por HTTP. 


Alteraram-se apenas o título da página e o valor da opção action, que contém o nome 
do programa PHP que irá receber o arquivo. O código-fonte é apresentado a seguir: 
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upload ftp.html 


<html> 

<head> 

<titlesLivro de PHP - Upload de arquivo por FiP«/title> 

</head> 

<body> 

<h2 align="center">Upload de Arquivo por FTP</h2> 

<form method=POST action="executa upload ftp.php" enctype=multipart/form-data> 
<input type="hidden" name="MAX FILE SIZE" value="200000"> 
<p align=center>Arquivo: <input type="file" name="arquivo" size="30"> 
<p align-center><input type=submit value="Enviar arquivo"> 

</form> 

</body> 

</html> 


Para ver a descrição detalhada sobre o significado das principais linhas, consulte 
o tópico correspondente no tópico “Definindo o formulário HTML” do upload 
simples por HTTP 


Configuração do servidor e do upload 


Antes de começar o upload dos arquivos, você pode configurar suas preferências 
através do arquivo que nomeamos como config. upload ftp. inc. Esse arquivo tem todas 
as variáveis de configuração que vimos no config upload. inc, além das configurações 
relativas à conexão com o servidor FTP que receberá o arquivo. Acompanhe a seguir 
o código-fonte e logo após uma explicação sobre cada uma das variáveis: 


config upload ftp.inc 


<?php 

ff configurações do servidor FTP 

fservidor ftp = "192.168.1.36": 

fusario. ftp = "juliano"; 

$senha ftp = "12345" 

// limitar as extensões? (sim ou nao) 

Slimitar ext = "sim"; 

/f extensões autorizadas 

fextensoes validas = array(".gif",".jpg",".jpeg",".bmp"); 
ftcaminho absoluto onde os arquivos serão armazenados 
$caminho absoluto = "/upload"; 

ff Nimitar o tamanho do arquivo? (sim ou nao) 

$limitar tamanho = "nao"; 

!! tamanho limite do arquivo em bytes 

tamanho bytes = "200000"; 

ff! se já existir o arquivo, indica se ele deve ser sobrescrito (sim ou nao) 
$sobrescrever = "nao"; 

T> 
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As três primeiras variáveis ($servidor ftp, jusuario, ftp € $senha ftp) definem, respec- 
tivamente, o endereço do servidor FTP com o qual a conexão será aberta, o nome 
de usuário e a senha de conexão. Para ver a descrição detalhada sobre o significado 
das demais variáveis, consulte o tópico “Parâmetros de configuração do upload”, no 
upload simples por HTTP. 


Conectando ao servidor e enviando o arquivo 


A seguir será apresentado o programa responsável pela operação de upload por 
FTP Esse programa recebe o arquivo enviado pelo formulário da página upload ftp. 
htm, faz as devidas consistências e envia o arquivo para o local destino. Acompa- 
nhe o código-fonte e, logo após, leia as explicações sobre os principais trechos do 
programa: 


executa upload ftp.php 


<html> 

<head> 

«titlesLivro de PHP - Upload de arquivo por FTPe/title> 
</head> ” 

<body> 

<h2 align="center">Upload de Arquivos</h2> 

<? 

/! elimina o limite de tempo de execução 

set time limit (0); 

4! inclui o arquivo com as configurações 

include “config upload ftp.inc'; 

fnome arquivo = $.FILESE'arquivo'3['name']; 

$tamanho arquivo = $ FILES['arquivo'T['size']; 
arquivo temporario = $. FILES['arquivo']L "tmp name ']; 


if (Jempty (fnome arquivo)) 
{ 
if ($sobrescrever == "nao" && file exists("Scaminho absoluto/Snome arquivo") 
die("Arquivo já existe.) 
if (C$limitar tamanho == "sim") && (tamanho arquivo > $tamanho bytes)) 
die("Arquivo deve ter no máximo $tamanho bytes bytes. 9; 
text = strrchr(Snome arquivo, ".); 
if €$limitar ext == "sim" && lin array(Sext, Sextensoes validas)) 
die("Extensão de arquivo inválida para upload. "}; 


4! abre uma conexão FTP 
$id conexao = ftp connect(fservidor ftp): 
4! realiza o login com o nome de usuário e senha 
Slogin = ftp login(fid conexao, $usario ftp, fsenha ftp); 
f/ verifica se houve sucesso na conexão 
if €C!Sid conexao) || (!Slogin)) 
{ 
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echo "Não foi possível abrir conexão FTP com o servidor Sservidor ftp"; 
exit; 

} 

else 
echo "Usuário $usario_ftp conectado ao servidor $servidor_ftp <br>"; 


/! faz o upload do arquivo 
Sarquivo destino = "$Scaminho absoluto/fnome arquivo"; 
jupload = ftp put(fid conexao, Sarquivo destino, Sarquivo temporario, FTP BINARY); 


/! verifica se houve sucesso no upload 
if (!Supload) 
echo "<p align=center>0 upload do arquivo Snome arquivo falhoul</p>”; 
else 
{ 
echo “<p align=center>0 upload do arquivo $nome_arquivo foi concluído com 
sucessol</p>": 
echo "<p align=center><a href=upload ftp.htmi>Novo upload</a></p>"; 


/! Fecha a conexão FTP 

ftp close($id conexao); 
} 
else 

die("Selecione o arquivo a ser enviado"); 
?> 


</body> 
</html> 


r 


Vamos analisar agora os trechos de código novos em relação ao upload feito 
anteriormente pelo arquivo executa upload. php. O comando include foi utilizado para 
incluir o arquivo que contém as variáveis de configuração do servidor e da operação. 
Isso foi feito por meio da seguinte linha: 


include "config upload ftp.inc”; 


A obtenção das informações sobre o arquivo recebido, assim como as consistên- 
cias em relação às variáveis de configuração, foi feita da mesma forma que o upload 
simples por HTTP. Logo, para obter a descrição detalhada sobre esses trechos de 
código, consulte o tópico “Recebendo e gravando o arquivo” 


Após realizadas todas as consistências, iniciamos a conexão FTP através da 
função ftp connect, que possui a seguinte sintaxe: 


recurso ftp connect (string servidor [, int porta [, int tempo])) 
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Parâmetro Descrição 
servidor Nome ou endereço IP do servidor com o qual a conexão será aberta. 
porta Especifica a porta do sistema operacional na qual será feita a conexão. 


Se for omitida ou for igual a zero, será usada a porta 21, padrão para 
conexões FTP. 


tempo Define o tempo máximo de espera para as operações seguintes. Se 
for omitido, será utilizado o valor-padrão (90 segundos). Esse tempo 
pode ser consultado ou alterado a qualquer momento com as funções 
ftp set option e ftp get option. 


O estabelecimento da conexão FTP foi feito por meio da seguinte linha: 
Sid conexao = ftp connect(fservidor ftp); 


Nesse exemplo, estamos armazenando esse endereço na variável $servidor ftp, que 
deve ser configurada previamente no arquivo config upload ftp.inc. O próximo passo 
é realizar a autenticação no servidor, fornecendo o nome de usuário e senha. Isso é 
feito com o uso da função ftp login, que possui a seguinte sintaxe: 


bool ftp login (recurso id conexão, string usuário, string senha) 


Parâmetro Descrição 

id conexão Identificador da conexão aberta previamente pelo comando ftp. 
connect. 

usuário Nome de um usuário (username) autorizado no servidor de FTP 

senha Senha de acesso para o usuário especificado. 


Em nosso exemplo, o login foi feito através da linha a seguir, As variáveis $usu- 
ario. ftp e $senha ftp também devem ser previamente configuradas no arquivo de 
configuração: 


Slogin = ftp Togin(fid conexao, fusario ftp, fsenha ftp); 


Para verificar se houve sucesso na conexão e a autenticação do usuário, testa-se 
o conteúdo das variáveis que receberam o resultado das operações: 


if (C!$id conexao) || (!Slogin)) 


{ 
echo "Não foi possível abrir uma conexão FTP com o servidor $servidor_ftp"; 
exit; 

} 

else 


echo "Usuário $usario_ftp conectado ao servidor $servidor_ftp <br>"; 
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As funções ftp connect e ftp Jogin retornam o valor FALSE em caso de falha. Se houve 
sucesso, será exibida uma mensagem confirmando o estabelecimento da conexão €, 
então, utilizamos o comando ftp put para enviar o arquivo por FTP a seu diretório 
destino. Sua sintaxe é a seguinte: 


bool ftp put (recurso id conexão, string arq remoto, string arq iocal, int modo 
[, int pos inicial) 


Parâmetro Descrição 


id conexão Identificador da conexão aberta previamente pelo comando ftp. 
connect. 


arq remoto Define o nome com o qual o arquivo será armazenado no servidor 


FTE 
arg Toca? Nome do arquivo local que será enviado ao servidor FTP 
modo Modo de transferência. O arquivo pode ser transferido no modo texto 


(FTP_ASCII) ou binário (FTP. BINARY). 


pos inicial Parâmetro opcional, adicionado à versão 430 do PHP Define a posição 
inicial do arquivo a partir da qual deve começar o envio. 


Para definir o local destino do arquivo que estamos transferindo no programa exe- 
cuta upload ftp. php, foi feita a concatenação do caminho base (variável $carrinho absoluto 
do arquivo com as variáveis de configuração) com o nome original do arquivo e, 
logo após, executada a função ftp put para realizar o envio: 


farquivo destino = "fcami nho absoluto/$none. arquivo”; 
Supload = ftp putíSid conexao, Sarquivo destino, Sarquivo. temporario, FFP BINARY); 


Em caso de falha, a função ftp put retorna FALSE. Assim, podemos testar se re- 
almente o upload ocorreu com sucesso, caso contrário exibimos uma mensagem 
informando sobre a falha na operação: 


if (fupload) 
echo “<p align=center>0 upload do arquivo $nome arquivo falhou! </p>"; 


Para finalizar o programa, encerramos a conexão FTP com o comando ftp close, 
que recebe como parâmetro o identificador da conexão que desejamos finalizar: 


ftp close(Sid conexao); 


Enviando múltiplos arquivos 


O suporte para o envio de múltiplos arquivos existe desde a versão 3010 do PHP. 
Se você pretende permitir ao usuário selecionar mais de um arquivo, de forma que 
o programa fique o mais genérico possível e não haja necessidade de repetição de 
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código, existem duas maneiras de fazer isso. Pode-se utilizar variáveis em sequência 
ou um array O uso do array é muito mais simples, porém veremos como imple- 
mentar as duas formas. 


Utilizando variáveis em segiiência 


Essa forma de envio consta em definir um nome diferente para cada campo do 
tipo “file” do formulário HTML. Porém, esses nomes devem formar uma segiúência 
definida pelo nome do campo mais um número identificador. Por exemplo, observe 
a tela mostrada na figura 6.3. 


Nomeamos esse arquivo como upload multiplo.html. Acompanhe agora seu códi- 
go-fonte. 


http: /lacalhost/upload/, 


Figura 6.3 — Seleção de múltiplos arquivos para upload. 


upload multiplo.html 


<html> 

<head> 

«title>Livro de PHP - Upload de múltiplos arquivos</title> 

</head> 

<body> 

<hz align="center">Upload de múltiplos arquivos</h2> 

<form method=POST action="executa upload multiplo. php" enctype=multipart/form-data> 
<input type="hidden" name="MAX FILE SIZE” value="200000"> 

<p align=center>Arquivo 1: <input type="file” name=“arquivol" size="30"></p> 
<p align=center>Arquivo 2: <input type="file” name="arquivo?” size="30"></p> 
<p align=center>Arquivo 3: <input type="file” name=“arquivo3” size="30"></p> 
<p align=center>Arquivo 4: <input type="file" name=“arquivod” size="30"></p> 
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<p align=center>Arquivo 5: <input type="File" name="arquivos" size="30"></p> 
<p align=center><input type=submit value="Enviar arquivos"></p> 

</form> 

</body> 

</html> 


Veja que, no formulário HTML, foram criados cinco campos do tipo file, nome- 
ados como arquivol, arquivo, arquivo3, arquivos e arquivoS. Os nomes dos campos são 
quase iguais, só alteramos o último dígito, que vamos utilizar como um número 
identificador dentro do script PHP, A idéia é montar o nome do elemento de forma 
dinâmica dentro do programa, para que possamos executar cinco vezes o mesmo 
código, em vez de repeti-lo. 


Para configuração da operação, será utilizado o mesmo arquivo config upload. inc, 
definido no tópico “Parâmetros de configuração do upload” A página que irá receber 
e processar os arquivos foi nomeada como executa upload multiplo.php e seu código- 
fonte será apresentado a seguir. Acompanhe o código e logo após as explicações: 


executa uptoad multipio.php 


<html> 
<head> 
«title>Livro de PHP - Upload de múltiplos arquivos</title> 
</head> 
<body> 
<h? align="center">Upload de múltiplos arquivos</h2> 
<? 
/f elimina o limite de tempo de execução 
set time limit (0); 
// inclui o arquivo com as configurações 
include "config upload.inc'; 
/f repete os mesmos comandos para os 5 arquivos 
for (Si = 1; $i <= 5; $i++) 
{ 
$id arquivo = "arquivo". $i; 
farra = FALSE; 
fnome arquivo = $ FILES[fid arquivo] ['name'"]; 
$tamanho arquivo = $ FILES[$id arquivo] 'size']: 
Sarquivo temporario = $ FILES[$id arquivo] [tmp name']: 
if (lempty Cinome arquivo)) 
1 
if Csobrescrever == "nao" && file exists("Ecaminho absoluto/Snome arquivo")) 
{ 
$erro = TRUE; 
echo "Arquivo $nome_arquivo já existe. "; 
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if CC$limitar tamanho == "sim") && ($tamanho arquivo > $ftamanho bytes)) 


{ 
$erro = TRUE; 
echo "Arquivo $nome_arquivo deve ter no máximo $tamanho_bytes bytes. "; 


} 
$ext = strrchr($nome_arquivo,'.'); 
if ($limitar_ext == "sim" && lin array(Sext, $extensoes_validas)} 
{ 
ferro = TRUE; 
echo "Extensão do arquivo $nome arquivo inválida para upload."; 


F 
if (JSerro && move uploaded file(farquivo. temporario, 
“$caminho absoluto/$nome. arquivo") 
echo "<p align=center>0 upload do arquivo <b>$nome arquivo 
</b> foi concluído com sucesso.</p>": 
else 
echo "<p align=center>0 arquivo nome, arquivo não pôde ser copiado para o 
servidor.</p>": 


} 


7> 
</body> 
</html> 


Assim como nos outros scripts de upload apresentados neste capítulo, inicia- 
mos eliminando o limite de tempo (set_time_timit) e adicionando uma chamada ao 
arquivo de configuração. Logo após, utilizou-se o comando for para criar um laço 
de repetição, com a variável de controle $i iniciando no valor 1 e finalizando no 
valor 5. Assim podemos usar o mesmo bloco de comandos para manipular todos 
os arquivos recebidos. Observe agora as linhas seguintes: 


fid arquivo = "arquivo". $i; 

Serro = FALSE; 

fnome arquivo = $ FILES[Sid arquivo] ['name']; 

$tamanho arquivo = $ FILES[Sid arquivol['size']; 
farquivo temporario = $ FILES[$id arquivo][ tmp name 'I; 


Veja que o identificador do arquivo, que indica o elemento a ser acessado no array 
$_FILES, foi criado dinamicamente. Definimos o prefixo “arquivo” que é concatenado 
ao valor de $i na iteração atual. A variável Serro foi definida para indicar quando 
alguma das consistências falhar, a fim de evitar a cópia do arquivo sem interromper 
a execução do programa. 


Após a realização de todos os testes baseados nas variáveis de configuração, o 
upload será concluído ou será exibida uma mensagem de erro. Esse procedimento 
será realizado para cada um dos arquivos recebidos: 
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if (!ferro && move uploaded file(Sarquivo temporario, "fcaminho absoluto/fnome arquivo”) 
echa "<p align=center>0 upload do arquivo <b>fnome arquivo</b> foi concluído com 
sucesso. </p>"; 
else 
echo "<p align=center>0 arquivo fnome arquivo não pôde ser copiado para 9 servidor. </p>": 


Note que o usuário não é obrigado a escolher cinco arquivos para enviar. O 
programa irá tentar localizar os identificadores arquivol, arquivo2, arquivo3, arquivos e 
arquivos. Caso não encontre nenhum deles, simplesmente não serão executados as 
consistências nem o upload. Isso significa que se o usuário preencher, por exemplo, 
apenas o primeiro e o quinto campo, funcionará da mesma forma que se ele preen- 
chesse somente os dois primeiros. 


Você pode alterar o script para aceitar mais ou menos de cinco arquivos, bas- 
tando adicionar ou retirar campos do tipo file no formulário e ajustar o valor da 
variável $i no script. 


Utilizando um array 


Essa forma de envio consiste em definir um único nome para todos os campos do 
tipo file, e esse nome deve ser precedido pelos colchetes ([ ]). 


Dessa forma, o script PHP irá considerar cada um desses campos como um 
elemento do array 4. FILES, que ganhará uma terceira dimensão, representada pelo 
índice do arquivo. Isso pode lhe parecer confuso, mas na realidade esse método 
torna a programação muito mais simples. Veja a seguir, no arquivo que nomeamos 
como upload multiplo array.html, como ficará o formulário HTML: 


& upload multiplo array.html 


<html> 

<head> 

«titlesLivro de PHP - Upload de múltiplos arquivos</title> 

</head> 

<body> 

<h2 align="center">lpload de múltiplos arquivos</h2> 

<form method=POST action="executa upload multiplo array. php" enctype=multipart/form-data> 
<input type="hidden” name="MAX FILE SIZE” value="200000"> 

<p align=center>Arquivo 1: <input type="file"” name="arquivo[]" size="30"></p> 
<p align=center>Arguivo 2: <input type="File" name="arquivo[]" size="30"></p> 
<p align=center>Arquivo 3: <input type="file” name="arquivof]" size="30"></p> 
<p align=center>Arguiva 4: <input type="file” name="arguivo[]" size="30"></p> 
<p align=center>Arquivo 5: <input type="Fite" name="arquivo[]" size="30"></p> 
<p align=center><input type=submit value="Enviar arquivos"></p> 

</form> 

</body> 

</html> 
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No programa que irá receber os arquivos, o executa upload multiplo array.php, usa- 
mos o comando de repetição for para acessar os elementos referentes a cada um 
dos arquivos recebidos. Em relação ao exemplo anterior, você poderá notar duas 
diferenças no tratamento dos arquivos. Acompanhe a seguir o código-fonte do 
programa e logo após a explicação: 


executa upload multiplo array.php 


<html> 

<head> 

«title>Livro de PHP - Upload de múltiplos arquivos</title> 

</head> 

<body> 

<h2 align="center">Upload de múltiplos arquivos</h2> 

<? 

ff elimina o limite de tempo de execução 

set time Jimit (0); 

!f inclui o arquivo com as configurações 

include "config upload.inc'; 

Ż/ repete os mesmos comandos para os 5 arquivos 

for ($i =0; $i < 5; Sim) 

í a 
ferro = FALSE; 
fnome arquivo = $ FILES['arquivo']['name'] [$i]; 
$tamanho arquivo = $ FILES['arquivo") ['size'] [Bi]; 
tarquivo temporario = $. FILESF "arquivo" [tmp name) [$i]; 
if Clempty (nome arquivo)) 


{ 
if ($sobrescrever == "nao" && file_exists("$caminho_absoluto/$nome_arguivo")) 
{ 
$erro = TRUE; 
echo "Arquivo $nome_arquivo já existe. "; 
k 
if (($limitar tamanho == "sim") && ($tamanho arquivo > $tamanho bytes)) 
{ 
Serro = TRUE; 
echo "Arquivo nome arquivo deve ter no máximo Stamanho bytes bytes.”; 
k 
$ext = strrchr(Snome arquivo, '.'); 
if CSlimitar ext == "sim" && lin array(õext, Sextensoes validas)) 
{ 
Serro = TRUE; 
echo "Extensão do arquivo Snome arquivo inválida para upload. "; 
} 


if (!ferro & move uploaded file(farquivo temporario, 
“$caminho absoluto/Snome arquivo")) 
echo "<p align=center>0 upload do arquivo <b>fnome arquivos/b> 
foi concluído com sucesso. </p>"; 
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else 
echo “<p align=center>0 arquivo $nome arquivo não pôde ser copiado para O 
servidor,</p>"; 
h 
} 
7> 
</body> 
</html> 


Note que agora a variável de controle $i varia de O a 4, visto que o array tem início 
na posição zero. A outra diferença está no modo como são acessadas as informações 
sobre os arquivos, pois o array $_FILES ganhou uma terceira dimensão: 


Snome arquivo = & FILES[ "arquivo" 3['name'] [Hi]; 
$tamanho arquivo = $ FILES[ "arquivo IL 'size' TES]; 
Sarquivo temporario = $ FILES['arquivo']L'tmp name" [$i]; 


A terceira dimensão representa o Índice do arquivo no vetor. O primeiro arquivo 
enviado será o de índice 0, o segundo será o de índice 1, e assim por diante. Nesse 
caso, usamos o valor da variável $i para representar esse índice. A programação 
torna-se mais simples, visto que não há necessidade de montar dinamicamente 
o identificador do arquivo, Assim como no exemplo anterior, você também pode 
alterar o script aumentando o intervalo de variação do $i, podendo permitir ao 
usuário enviar mais de cinco arquivos. 


Problemas comuns 


Caso você não consiga realizar a operação de upload, a seguir são listadas algumas 
das possíveis causas do problema: 


" Verifique se o diretório no qual você está tentando gravar o arquivo possui 
permissão de escrita, caso contrário o PHP não conseguirá mover o arquivo 
do diretório temporário para o diretório destino. 


* O parâmetro MAX FILE SIZE do formulário HTML não pode especificar um 
tamanho de arquivo maior do que aquele especificado na diretiva upload max fi- 
lesize do arquivo de configuração php. ini. O valor-padrão é 2 MB, 


* Seo limite de memória estiver ativado (diretiva memory_limit do php. ini), poderá 
impedir o upload de seu arquivo. Certifique-se de que esse valor é grande o 
suficiente. 
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* Sea diretiva max execution time do php.ini possuir um valor muito pequeno, 
a execução de seu script poderá ultrapassar o limite de tempo e o upload 
será interrompido. Como vimos nos exemplos deste capítulo, se usarmos o 
comando set time limit (0) dentro do script, eliminaremos o limite de tempo 
e não precisaremos nos preocupar com a diretiva max execution time. 


* À diretiva post. max size do php.ini define o tamanho máximo para dados 
enviados pelo método POST. Se possuir um valor muito pequeno, isso poderá 
impedir o upload, Certifique-se de que esse valor é grande o suficiente. 


Importante: por questões de segurança, faça sempre a validação do arquivo 
recebido no script PHP, principalmente quanto à extensão deste, Assim, você evita 
que o usuário possa enviar, por exemplo, um arquivo com extensão .php contendo 
um script que acessa dados conhdenciais de seu sistema. 


Mensagens de erro 


À partir da versão 4.20 do PHP, existe um elemento adicional no array $_FILES, que 
armazena um código de erro quando a operação de upload falhar. O nome da pro- 
priedade é error, ou seja, esse código pode ser acessado em $. FILES['arquivo']['error'], 
considerando que utilizamos o identificador “arquivo” no formulário HTML. 


À seguir, serão apresentados os possíveis valores para esse elemento. No PHP 
430, esses valores tornaram-se constantes. 


Constante Descrição 


UPLOAD. ERR OK Equivale ao valor 0. Indica que não houve erro e o upload 
ocorreu com sucesso. 


UPLOAD ERR INT SIZE Equivale ao valor 1. Indica que o tamanho do arquivo recebido 
é maior que o valor definido na diretiva upload max filesize 
do php. ini. 

UPLOAD ERR FORM SIZE Equivale ao valor 2. Indica que o tamanho do arquivo 
selecionado pelo usuário é maior que o valor definido no 
parâmetro MAX FILE SIZE do formulário HTML. 


UPLOAD ERR PARTIAL Equivale ao valor 3. Indica que o upload do arquivo foi feito 
parcialmente. 
UPLOAD. ERR NO FILE Equivale ao valor 4. Indica que o upload do arquivo não foi 


feito. 
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Funções de FTP disponíveis no PHP 


Além das principais funções que vimos neste capítulo, existem várias funções 
adicionais para a utilização do protocolo FTP na linguagem PHP. A seguir, serão 
apresentadas as funções que podemos utilizar e uma pequena descrição de cada 
uma delas. 
ftp cdup 

Altera para o diretório que está um nível acima (parent). 

bool frp cdup (recurso td conexão) 
ftp chdir 

Altera o diretório em um servidor FTP. 


bool ftp chdir (recurso id conexão, string diretório) 


ftp chmod 
Define as permissões de um arquivo via FTP. 


string ftp. chmod (recurso id conexão, int modo, string nome arquivo) 


ftp close 
Fecha uma conexão FTP 


void ftp close (recurso id conexão) ” 


ftp connect 


Abre uma conexão FTP 


recurso ftp connect (string servidor [, int porta E, int tempo max])) 


ftp delete 


Exclui arquivos em um servidor FTP. 


bool ftp delete (recurso id conexão, string caminho) 


fip exec 


Solicita a executação de um programa no servidor FTP, 


bool ftp exec (recurso id conexão, string comando) 


fip fget 
Faz o download de um arquivo do servidor FTP e salva em um arquivo 
aberto. 


bool ftp fget (recurso id conexão, recurso handle arquivo, string arg remoto, 
int modo [, int pos reiniciar)) 
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ftp fput 
Envia de um arquivo aberto para um servidor FTP 
bool ftp fput (recurso id conexão, string arg remoto, recurso handle arg, 
int modo [, int pos inicial]) 
ftp get option 


Retorna diversas configurações em tempo de execução da conexão FTP 
corrente. 


misto ftp get option (recurso id conexão, int opção) 


ftp get 
Faz o download de um arquivo do servidor FTP. 


bool ftp get (recurso id conexão, string arg Tocal, string arq remoto, int modo 
[, int pos reiniciar] 
ftp login 
Realiza o login em uma conexão FTP 


bool ftp login (recurso id conexão, string nome usuário, string senha) 


ftp mdtm 


Retorna a hora da última modificação de determinado arquivo. 


int ftp mdtm (recurso id conexão, string arg. remoto) 


ftp mkdir 
Cria um diretótio. 


string ftp.mkdir (recurso td conexão, string diretório) 


ftp nb continue 


Continua enviando ou recebendo um arquivo (não-bloqueante). 


bool ftp nb continue (recurso id conexão) 


ftp nb fget 
Retorna um arquivo de um servidor FTP e o grava em um arquivo aberto 
(não-bloqueante). 


bool ftp nh fget (recurso id conexão, recurso handle arg, string arq remoto, 
int modo E, int pos reiniciary) 
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ftp nb fput 
Armazena um arquivo aberto em um servidor FTP (não-bloqueante). 


bool ftp.nb fput (recurso id conexão, string arg remoto, recurso handle arg, 
int modo [, int pos inicial) 


ftp nb get 


Retorna um arquivo de um servidor FTP e o grava em um arquivo local 
(não-bloqueante). 


bool ftp.nh get (recurso id conexão, string arq local, string arq. remoto, 
int modo [, int pos reiniciar)) 


ftp nb put 
Armazena um arquivo no servidor FTP (não-bloqueante). 


bool ftp nb put (recurso id conexão, string arg remoto, string arg local, 
int modo [, int pos inicial) 


ftp. nlist 
Retorna uma lista dos arquivos em determinado diretório. 


array ftp nlist (recurso id conexão, string diretório) 


ftp pasv 
Ativa ou desativa o modo passivo. - 


bool ftp pasv (recurso id conexão, bool passivo) 


ftp put 
Envia (upload) um arquivo para um servidor FTP 


bool ftp put (recurso id conexão, string arg remoto, string arg local, int modo 
[, int pos inicial) 


ftp pwd 

Retorna o nome do diretório corrente. 

string ftp pwd (recurso id conexão) 
ftp quit 

Fecha uma conexão FTP. Apelido (alias) para a função ftp.close. 
ftp raw 

Envia um comando arbitrário para um servidor FTP 


array ftp ram (recurso id conexão, string comando) 
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ftp rawlist 
Retorna uma lista detalhada dos arquivos em determinado diretório. 


array ftp rawlist (recurso id conexão, string diretório) 


ftp rename 
Renomeia arquivos em um servidor FTP, 


bool ftp rename (recurso id conexão, string nome atual, string novo nome) 


ftp. imdir 
Remove um diretório. 
bool ftp emdir (recurso id conexão, string diretório) 
ftp set option 
Define diversas opções do FTP em tempo de execução. 
bool Ttp set option (recurso id conexão, int opção, misto valor) 
ftp site 
Envia um comando do tipo SITE ao servidor. 
bool ftp site (recurso id conexão, string comando) 
fip size 
Retorna o tamanho de determinado arquivo. 


int ftp.size (recurso id conexão, string arg remoto) 


ftp ssl connect 
Abre uma conexão segura SSL-FTP. 
recurso ftp ssi connect Estring servidor [, int porta [, int tempo max]]) 
ftp systype 
Retorna o identificador do tipo de sistema do servidor remoto de FTP 


string ftp systype (recurso id conexão) 


Capítulo 7 


À arte de gerar imagens no PHP 


Neste capítulo, você irá aprender a trabalhar com imagens no PHP Serão apresentados 
todos os passos básicos para a criação de imagens, assim como para a alteração de ima- 
gens já existentes. Serão apresentados também as funções responsáveis por desenhar 
os elementos gráficos básicos e, ao final do capítulo, alguns exemplos de aplicações 
que podem ser criadas usando essa biblioteca gráfica disponível para o PHE 


Por que manipular imagens? 


Provavelmente você já tenha ouvido a famosa frase: “Uma imagem vale mais que 
mil palavras”. O uso de imagens em um website o torna muito mais atrativo do 
que aqueles que são feitos apenas com textos. Imagine, então, o quanto seu website 
poderia ficar mais atrativo se você exibisse imagens personalizadas aos visitantes. 
O PHP é uma linguagem de programação para criar páginas dinâmicas, que nos 
permite criar não só tais páginas, mas também imagens dinâmicas. Entre as diver- 
sas aplicações que podemos criar para realizar manipulação de imagens no PHP, 
podemos destacar as seguintes: 


* Imagens personalizadas: imagine que interessante seria se, ao fazer o login em um 
website, fosse exibida uma imagem lhe dando boas-vindas, com seu nome 
gravado nela. Chamaria mais atenção do que se a saudação fosse feita com 
um simples texto: “Olá Fulano!” Esse é um tipo de personalização de ima- 
gem para o visitante, Outro exemplo que pode ser citado são os websites que 
permitem o envio de cartões, que podem oferecer 20 remetente a opção de 
personalizar a imagem incluindo o nome do destinatário no meio da figura. 
Como veremos mais adiante, pode ser feita também uma personalização de 
imagens para o próprio site. Para isso, pode-se criar um programa PHP que 
altere uma imagem, gravando nela algum texto ou elemento gráfico para 
indicar que a imagem pertence a seu site. Isso tudo de forma automatizada, 
sem precisar utilizar um editor gráfico. 
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Miniaturas de imagens: são muito comuns na web e conhecidas normalmente 
como thumbnails. Você já deve ter visto muitas vezes uma imagem em for- 
mato reduzido, acompanhada pela frase “Clique aqui para ampliar” Veremos 
mais adiante que existem duas formas de apresentar essas miniaturas aos 
usuários. 


Uma delas é exibir a imagem original em dimensões reduzidas, enquanto a 
outra consiste em gerar as miniaturas em arquivos separados. É aí que entra 
o PHP, pois a geração desses arquivos pode ser feita de forma automática, o 
que lhe pouparia um bom tempo. 


Contadores de acesso: normalmente não são exibidos em grandes portais, mas 
são muito comuns em websites menores. Os webmasters que optarem por 
exibir aos visitantes o número de acessos que seu site já obteve podem uti- 
lizar o PHP para criar seu próprio contador em formato gráfico, em vez de 
utilizar programas de terceiros, Ao utilizar um contador próprio, você terá a 
vantagem de ter o script localizado em seu próprio servidor, o que irá acelerar 
sua execução e evitar que o contador não seja exibido, como poderia ocorrer 
caso o servidor do fornecedor do script estivesse fora do ar. 

Geometria: a biblioteca gráfica nos disponibiliza funções para desenhar diver- 
sas figuras geométricas, tais como retângulos, quadrados, círculos, elipses e 
polígonos. Utilizando essas funções, com um pouco de criatividade, podemos 
criar os mais variados tipos de aplicações que necessitem de algum tipo de 
representação geométrica. Por exemplo, um website de matemática pode criar 
um programa para ensinar geometria plana às crianças, permitindo que elas 
alterem as medidas das figuras e visualizem o resultado produzido. 


Gráficos: talvez seja a aplicação mais útil e interessante das funções de imagens 
do PHP. Você já pensou em gerar gráficos semelhantes aos do Excel e exibi-los 
em seu website? Se você tem um website que utiliza algum banco de dados, 
seja qual for (MySQL, PostgreSQL, Oracle etc), é possível criar um programa 
PHP para extrair informações desse banco de dados e criar em tempo real 
uma representação gráfica para essas informações. O resultado é visualizado 
no próprio programa navegador, não havendo necessidade de exportar os 
dados para um programa que gere gráficos (como o Excel). Por exemplo, se 
você tem os usuários de seu website cadastrados em um banco de dados, é 
possível criar um programa PHP para visualizar a qualquer momento um 
gráfico representando a segmentação desses usuários por um determinado 
critério, como, por exemplo, estado, sexo etc. Neste capítulo, você irá aprender 
a gerar três tipos de gráficos. 


160 PHP para quem conhece PHP 


Introdução à biblioteca gráfica GD 


Para criar e manipular imagens no PHP é necessária uma biblioteca chamada GD. 
Versões do PHP a partir da 4.3 já possuem uma versão da GD embutida. Para uti- 
lizarmos esta biblioteca, precisamos primeiro habilitá-la no arquivo php. ini, o que 
normalmente é feito por meio da seguinte linha: 


extension = php gd2.dN 


Após habilitá-la, basta reiniciar o servidor web para que o PHP passe a reco- 
nhecer os comandos da biblioteca. É preferível utilizar essa versão já existente do 
que usar alguma versão externa, em razão da estabilidade do código da GD que é 
disponibilizado com o PHP, 


Para versões do PHP anteriores a 43, essa extensão deve ser obtida no site http: // 
wmi.boute)1.com/gd/ € o PHP deve ser configurado para utilizá-la. A configuração no 
Unix/Linux consiste em compilar o PHP com suporte à biblioteca GD, enquanto no 
Windows a extensão está disponível em um arquivo .dl1, que precisa ser colocado 
no diretório das extensões do PHP e habilitado no arquivo de configuração php. ini. 
As instruções detalhadas de configuração acompanham a extensão. 


Os exemplos apresentados neste capítulo foram todos testados utilizando a versão 
da GD que acompanha o PHP É importante lembrar que versões mais atuais da GD 
podem possuir novas funções que não estão-disponíveis em versões mais antigas 
dessa biblioteca. Porém, a maioria das funções está presente em todas as versões. 


Tipos de imagens suportados 


Os tipos de imagens suportados dependem da versão da GD que você estiver utili- 
zando. As versões mais antigas, anteriores à versão 16, aceitavam imagens em formato 
GIF e não suportavam o formato PNG. Como o algoritmo de compressão do formato 
GIF (LZW - Lempel - Ziv - Welch) era patenteado pela Unisys, os desenvolvedores 
foram obrigados a retirar o suporte a esse formato nas versões posteriores à versão 
16, que passaram a aceitar o formato PNG (Portable Network Graphics), proposto 
pelo World Wide Web Consortium (W3C), Atualmente os programas navegadores 
mais utilizados já exibem imagens em formato PNG, então você poderá utilizá-lo 
sem problemas. 


A biblioteca GD também suporta o formato JPG, um dos mais populares da web, 
além de outros formatos como SWF e TIFE Nos exemplos deste capítulo, vamos 
gerar imagens em JPG e PNG, embora o tipo de imagem praticamente não interf- 
ra na programação, visto que para utilizar outro formato, basta alterar o nome da 
função que gera a imagem final. 
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Um detalhe importante a se ressaltar é que quando você for criar imagens 
dinâmicas e enviá-las direto ao programa navegador (em vez de gravá-las em um 
arquivo), a primeira coisa a ser feita no programa PHP será o uso do comando hea- 
der, para informar ao navegador qual o tipo de conteúdo que está sendo retornado. 
Por exemplo, em um programa que envia ao navegador uma imagem em formato 
PNG, a primeira linha deveria ser: 


headerC"Content-type: image/png"); 

Para imagens do tipo JPG, ficaria da seguinte forma: 
header ("Content-type: image/jpeg"); 

Nas versões que suportam o formato GIF, utilizaríamos: 


header("Content-type: image/gif"); 


Criando uma imagem 


A partir de agora, você irá aprender como manipular imagens no PHP. O primeiro 
passo consiste em utilizar a função Imagefreate para criar a imagem na qual iremos 
trabalhar. Sua sintaxe é a seguinte: 


recurso ImageCreate (int largura, int altura) 


Parâmetro Descrição 
Targura Valor em pixels, representando a largura da imagem a ser criada. 
altura Valor em pixels, representando a altura da imagem a ser criada. 


Essa função retorna um identificador representando a imagem em branco criada, 
que possui as dimensões definidas pelos parâmetros largura e altura, Esse identifi- 
cador será passado como parâmetro para diversas outras funções que irão operar 
sobre essa imagem. 


Por exemplo, para criar uma imagem JPG que será enviada ao programa nave- 
gador, iniciaremos o programa com as linhas mostradas a seguir. Considere os três 
pontos (...) como um trecho de código, que no momento não vem ao caso: 


<?php 

header("Content-type: image/jpeg"); 

Simagem = ImageCreate(150,40); 

?> 

Nesse exemplo, estamos criando uma imagem nas dimensões de 150x40 pixels. Vere- 
mos, a seguir, que a primeira linha (comando header) não será necessária caso a imagem 
seja gravada em um arquivo em vez de ser enviada diretamente ao navegador. 
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A função ImageCreate cria uma imagem vazia. Se você quisesse trabalhar em uma 
imagem JPG já existente, deveria utilizar a função ImageCreaterromIPEG. Por exemplo: 


Simagem = InageCreateFromIPEG(" teste. jpg"); 


O uso dessa função será abordado mais adiante, no tópico sobre a geração de 
miniaturas de imagens. 


Definindo as cores 


Após criar a imagem, o passo seguinte é definir as cores que você irá utilizar. Cada cor 
deve ser alocada com a função ImageColorAMocate, que possui a seguinte sintaxe: 


int ImageColorATIocate (recurso imagem, int vermelho, int verde, int azul) 


Parâmetro Descrição 

imagem Identificador da imagem retornado pela função ImageCreate. 

vermelho Valor entre O e 255 que representa o primeiro componente (vermelho) 
da cor desejada. 

verde Valor entre O e 255 que representa o segundo componente (verde) da 
cor desejada. 

azul Valor entre O e 255 que representa o terceiro componente (azul) da cor 
desejada. 


Essa função retorna o identificador da ċor formada pelos componentes RGB 
(Red, Green, Blue) fornecidos. Esse identificador será passado como parâmetro para 
diversas outras funções que irão produzir algum efeito visual na imagem. 


A primeira cor alocada será utilizada como segundo plano, ou seja, como cor de 
fundo da imagem. Por exemplo, para criar uma imagem com fundo azul e conteúdo 
branco, nosso script deverá iniciar como o apresentado a seguir: 

<?php 

header("Content-type: image/jpeg"); 

Simagem = InageCreate(150,40); 


$azul = ImageColorATocate(Simagem, O, O, 255); 
$branco = InageColorATIocate(fimagem, 255, 255, 255); 


?> 

Os componentes 0, 0, 255 formam a cor azul, enquanto os componentes 255, 
255, 255, a cor branca. Você pode alocar quantas cores achar necessário para uma 
imagem. No momento de desenhar algum objeto ou escrever algum texto, basta 


passar como parâmetro o identificador da cor desejada, retornado pela função 
ImageColorAáliocate. 
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Se ainda não memorizou as combinações de valores dos componentes RGB que 
formam cada cor, utilize a tabela a seguir para formar as cores mais comuns. 


Cor 


Amarelo 


Azul 


Azul-marinho 


Cinza 


Laranja 


Magenta 


Marrom 


Preto 


Rosa 


Verde 


Vermelho 


Definindo o conteúdo 


Após criar a imagem e alocar as cores que serão utilizadas, a imagem estará pronta 
para receber seu conteúdo. É você quem define o tipo de conteúdo que a imagem vai 
possuir, bastando utilizar as funções de imagens do PHP. O nome dessas funções 
são case-insensitives, ou seja, tanto faz se você os digitar com letras maiúsculas ou 
minúsculas. Neste capítulo veremos com detalhes as principais funções de imagens. 
De forma resumida, podemos destacar as seguintes: 


Função Descrição 

ImageLine Desenha linhas, 
ImageRectangle Desenha um retângulo. 
ImageAre Desenha um arco. 

ImageE ipse Desenha círculos e elipses. 
InagePolygon Desenha um polígono. 
ImageString Desenha um texto. 


ImageFilNToBorder  Preenche uma região com uma determinada cor. 


Se quiséssemos, por exemplo, traçar uma linha em diagonal, que iniciasse no can- 
to superior esquerdo da imagem e que fosse até o canto inferior direito, teríamos que 
acrescentar o comando ImageLine em nosso programa, como mostrado a seguir: 
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<?php 

header("Content-type: image/jpeg"); 

Simagem = ImageCreate(150,40); 

$azul = IinageColorAlIocate(fimagem, O, O, 255); 
$branco = ImageloloraNocate(Simagem, 255, 255, 255); 
ImageLina (Simagem, O, O, 149, 39, Sbranco); 


?> 

O primeiro parâmetro do comando ImageLine é o identificador da imagem na qual 
a linha será traçada. O segundo e o terceiro indicam que a linha começa no ponto 
(0,0), enquanto o quarto e o quinto indicam que a linha termina no ponto (14939). 
O último parâmetro define que se deve utilizar a cor branca, alocada anteriormente. 


Esse é apenas um exemplo simples. No decorrer deste capítulo, veremos diversas 
formas de desenhar o conteúdo de uma imagem. 


Exibindo a imagem 


Depois de criar a imagem vazia e desenhar seu conteúdo com as funções de imagens 
do PHP, você precisa definir o destino da imagem resultante. Você deverá optar entre 
uma das duas opções: 


1. Enviar a imagem resultante diretamente para o programa navegador, sem 
armazená-la no servidor. Como se comentou anteriormente, nesse caso a 
primeira linha de seu programa PHP deve conter o comando header para 
indicar ao navegador o tipo de conteúdo que será enviado. Por exemplo: 
header ("Content-type: image/jpeg"); 


2. Gravar a imagem em um arquivo. Nesse caso, o programa não precisa iniciar 
com o comando header. Como a imagem estará gravada em um arquivo, você 
poderá retornar para o navegador um simples código HTML chamando a 
imagem. Normalmente, utiliza-se esse método quando a imagem gerada deve 
aparecer no meio do conteúdo de uma página, visto que no método anterior 
a imagem resultante será o único conteúdo recebido pelo navegador. 


O comando responsável por dar um desses dois destinos a uma imagem depen- 
de do tipo em questão. Por exemplo, para imagens do tipo JPEG, o comando é o 
ImageJpeg, e para imagens do tipo PNG, é o Image?ng. Nas versões da biblioteca GD 
que suportam o formato GIF, o comando é o ImageGif. 


Para modificar o tipo de imagem gerada, basta alterar esse comando. Por essa 
razão, em termos de programação o tipo não é muito relevante para os exemplos de 
geração de imagens que veremos neste capítulo. A seguir, será apresentada a sintaxe 
dos dois comandos mais utilizados em nossos exemplos, o ImageJpeg e O ImagePng. 
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int ImageJpeg (recurso imagem [, string arquivo [, int qualidade]]) 


Parâmetro Descrição 
imagem Identificador da imagem retornado pela função ImageCreate. 
arquivo Nome do arquivo no qual a imagem será gravada. Se for omitido, a 


imagem será enviada direto ao programa navegador. 


qualidade  Valorentre O (baixa qualidade e arquivo pequeno) e 100 (alta qualidade 
e arquivo grande). 


A função ImagePng é bastante parecida. Só não possui o parâmetro qualidade. 


int ImagePng (recurso imagem [, string arguivo]) 


Parâmetro Descrição 
imagem Identificador da imagem retornado pela função ImageCreate. 
arquivo Nome do arquivo no qual a imagem será gravada. Se for omitido, a 


imagem será enviada direto ao programa navegador. 


Acrescentando o comando para exibição da imagem em nosso exemplo, teremos: 


<?php 

header ("Content-type: image/jpeg"); 

Simagem = ImageCreate(150,40); 

Sazul = IrageColorATIocate(Simagem, 0, O, 255); 
Sbranco = ImageColorAtlocate(Simagem, 255, 255, 255); 


e 


InageJpeg(Simagem); 
7> 


Se quiséssemos salvar a imagem em um arquivo em vez de enviá-la direto ao 
programa navegador, usaríamos o segundo parâmetro da função ImageJpeg, elimina- 
riamos o comando header do início do programa e a imagem seria exibida por meio 
de um simples código HTML, como mostrado a seguir: 


<?php 

fimagem = ImageCreate(150,40); 

$azul = ImageColorAllocate{$imagem, O, O, 255); 
$branco = ImageColorA]locate($imagem, 255, 255, 255); 


ImageJpeg (Simagem, “nome arquivo. jpg"); 


?> 

<html> 

<title>Imagem gerada</title> 

<body> 

<p>Essa foi a imagem gerada pelo PHP!</p> 
<img src="nome arquivo. jpg"> 

</body> 

</html> 
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Liberando a memória utilizada 


Para finalizar o processo, devemos sempre liberar o espaço de memória alocado 
para a imagem. Isso é feito por meio do comando ImageDestroy. 


int ImageDestroy (recurso imagem) 


Chegamos, então, ao final de nosso programa exemplo apresentado a seguir: 


<?php 

header("Content-type: image/jpeg"): 

fimagem = ImageCreate(150,40); 

$azul = ImageColorATIocate(Simagem, O, 0, 255); 
fbranco = ImageColorAlTlocate(fimagem, 255, 255, 255); 


ImageJpeg(Simagem): 
ImageDestroy(Simagen); 
?> 


Agora você já conhece todos os passos que compõem a criação de uma imagem 
no PHP. A partir do próximo tópico, serão apresentados exemplos envolvendo di- 
versos elementos gráficos. 


Desenhando elementos gráficos básicos 


À seguir, veremos os principais elementos gráficos que podemos utilizar para dese- 
nhar o conteúdo de uma imagem criada dinamicamente com o PHP. É importante 
destacar que o topo de uma imagem, ou seja, seu canto superior esquerdo, corres- 
ponde ao ponto (0,0). Portanto, para determinar em que ponto (x,y) da imagem 
você deve desenhar, não a imagine como um gráfico com eixos X e Y Isso porque, 
ao contrário do sistema tradicional de coordenadas, o valor de y aumenta de cima 
para baixo. Use como referência sempre o topo da imagem. Aumentando o valor da 
coordenada x, você estará desenhando mais para a direita, e aumentando o valor 
da coordenada y, estará desenhando mais para baixo. 


Linhas 


A função responsável por desenhar linhas em uma imagem é a ImageLine, que possui 
a seguinte sintaxe: 


int ImageLine (recurso imagem, int x1, int yl, int x2, int y2, int cor) 
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Parâmetro Descrição 


imagem Identificador da imagem retornado pela função ImageCreate. 


xl Coordenada x do ponto a partir do qual a linha será traçada. 

yl Coordenada y do ponto a partir do qual a linha será traçada. 

x2 Coordenada x do ponto onde a linha deve terminar. 

y2 Coordenada y do ponto onde a linha deve terminar. 

cor Identificador da cor com a qual a linha será desenhada. Esse identificador 


deve ter sido retornado previamente pela função ImageColorAl locate. 


O exemplo apresentado a seguir, nomeado como Tlinha.php, cria uma imagem 
com as dimensões de 200x200 pixels e desenha nela duas linhas, uma em cada 
diagonal: 


linha.php 


<?php 

header("Content-type: image/jpeg"); 

Simagem = ImageCreate(200,200); 

gazul = ImageColorAllocate(Bimagem, 0, O, 255); 
fbranco = ImageColorAlIocate(Simagem, 255, 255, 255); 
ImageLine ($imagem, O, O, 199, 199, Sbranco); 
Imageline (fimagem, O, 199, 199, 0, branco); 
ImageJpeg(Simagem); 

ImageDestroy(Simagem); 

7> 


Antes de usar o comando ImageLine, seria possível definir a espessura da linha 
com o comando ImageSetThickness. Por exemplo: 


ImageSetThickness (Simagem, 10); 


Ao incluirmos esse comando antes do ImageLine, estaremos alterando a espessura 
da linha para 10 pixels. Se você incluir esse comando e o PHP não reconhecê-lo, 
significa que não está presente na versão da GD que você está usando. A figura 
71 mostra a imagem resultante, obtida ao acessar a página linha.php por meio do 
programa navegador. 
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Figura 7.1 — Desenhando linhas em uma imagem. 


Retângulos 


A função responsável por desenhar retângulos em uma imagem é a ImageRectangle, 


que possui a seguinte sintaxe: 
int ImageRectangle (recurso imagem, int xl, int y1, int x2, int y2, int cor) 


Parâmetro Descrição 


imagem Identificador da imagem retornado pela função ImageCreate. 


xi Coordenada x do ponto a partir do qual o retângulo será desenhado. 

yl Coordenada y do ponto a partir do qual o retângulo será desenhado. 

x2 Coordenada x do ponto onde o retângulo deve terminar. 

y2 Coordenada y do ponto onde o retângulo deve terminar, 

cor Identificador da cor que será usada na borda do retângulo. Esse identificador 


deve ter sido retornado previamente pela função ImageColorAlIocate. 


No exemplo apresentado a seguir, nomeado como retangulo. php, criou-se uma 
imagem PNG de fundo branco com as dimensões de 300x60 pixels, onde se dese- 
nhou um retângulo com a cor azul. 
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retangulo.php 


<?php 

header("Content-type: image/png"); 

Simagem = InageCreate(300, 60); 

$branco = ImageColorATIocate(Simagem, 255, 255, 255); 
fazul = ImageColorATlocate(Simagem, O, O, 255); 
ImageRectangte(Simagem, 0, O, 299, 59, Sazul); 
ImagePng(Simagem) ; 

InageDestroy(Simagem) ; 

?> 


Note que o retângulo inicia no ponto (00) e termina no ponto (299,59). Não 
existe o ponto (300,60), já que o primeiro ponto da imagem tem o valor O para x e 
y Caso você tente desenhar em uma coordenada x maior que ou igual a 300 ou em 
uma coordenada y maior que ou igual a 60, não ocorrerá erro algum, porém não 
será produzido nenhum efeito na imagem. A figura 7.2 mostra a imagem resultante, 
enviada ao navegador por meio do comando ImagePng. 


nételânguto. php - Hicrosoft In 


E 


Figura 7.2 — Desenhando retângulos em uma imagem. 


Veja que apenas a borda do retângulo possui a cor azul, Para desenhar um retângulo 
preenchido com uma determinada cor, basta substituir a função ImageRectangle pela 
InageFi TedRectangle. Essas duas funções recebem exatamente os mesmos parâmetros. 


Experimente alterar a linha que desenha o retângulo para: 


ImageFi VledRectangle(Simagem, O, O, 299, 59, Sazul); 


Ao visualizar o resultado no programa navegador, você verá um retângulo todo 
preenchido com a cor azul, como mostra a figura 73. 


Esse exemplo foi nomeado como retangulo2.php. Caso você queira preencher o 
retângulo com uma determinada cor e utilizar outra cor para desenhar a borda, 
basta utilizar primeiro o comando ImageFilledRectangle para desenhar o retângulo 
preenchido e, logo após, o comando ImageRectangle para desenhar a borda, passando 
outra cor como parâmetro, 


170 PHP para quem conhece PHP 


Figura 7.3 — Desenhando um retângulo com preenchimento. 


Por exemplo, para desenhar em uma imagem um retângulo vermelho com borda ver- 
de, seu programa deverá ter um trecho de código semelhante ao apresentado a seguir: 

<?php 

vermelho = ImageColorANocate(Simagem, 255, 0, 0): 

fverde = ImageColorATocate(Simagem, 0, 255, 0): 

ImageFil ledRectangle(Simagem, O, O, 299, 59, $vermelho); 

ImageRectangle(Simagam, 0, O, 299, 59, verde); 


?> 


Polígonos 


Polígono é uma figura plana formada pelo mesmo número de ângulos e lados. O 
número mínimo de lados aceito é 3, ou seja, o polígono de menor número de lados 
que podemos formar é um triângulo. A função ImagePolygon é a responsável por de- 
senhar polígonos. Sua sintaxe é a seguinte: 


int ImagePolygon (recurso imagem, array pontos, int num pontos, int cor) 


Parâmetro Descrição 
imagem Identificador da imagem retornado pela função ImageCreate. 
pontos Um array contendo os pontos do polígono. Cada dois elementos do 


array representam um ponto. Por exemplo: pontos [0] = x0, pontos[1] = 
y0, pontos[2] = x1, pontos[3] = y1, e assim por diante, 
num pontos Número total de pontos (ou vértices) do polígono. 


cor Identificador da cor que será usada na borda do polígono. Esse 


identificador deve ter sido retornado previamente pela função 
ImageColorAl locate. 
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Você deve fornecer pelo menos três pontos para essa função, caso contrário 
ocorrerá um erro na geração da imagem. Acompanhe o exemplo a seguir, que cria 
uma imagem PNG de fundo branco, com as dimensões de 300x300 pixels, e desenha 
um polígono de cinco lados usando a cor azul: 


& poligono.php 


<?php 

header ("Content-type: image/png"):; 

timagem = ImageCreate(300, 300); 

$branco = ImageColorA)Tocatre(fimagem, 255, 255, 255); 

gazul = ImageColorANocate(Simagem, , 0, 255); 

fnontos = array(10, 150, 150, 10, 290, 150, 240, 290, 60, 290): 
ImagePolygon(Simagem, pontos, 5, Sazul); 

ImagePna(Simagem) ; 

ImageDestroy(Simagem): 

7> 


Note que os vértices do polígono serão os pontos (10,150), (150,10), (290,150), 
(240,290) e (60,290). Portanto, estamos desenhando um pentágono. Observe, na 
figura 74, a imagem que obtemos ao abrirmos a página peligono. php no navegador. 


Figura 7.4 — Desenhando um poligono. 
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Assim como a função que desenha retângulos, a ImagePolygon também desenha 
apenas a borda da figura, deixando-a sem preenchimento. Para desenhar um polígo- 
no preenchido com uma determinada cor, basta substituir a função ImagePolygon pela 
ImageFilledPolygon, que recebe exatamente os mesmos parâmetros. Como exemplo, 
vamos criar uma imagem com fundo azul e desenhar uma estrela preenchida com 
a cor branca. Uma estrela nada mais é do que um polígono de dez lados. 


estrela.php 


<?php 
header("Content-type: image/png"); 
Simagem = ImageCreate(300, 300); 
$azul = ImageColorATlocate(Simagem, 0, O, 255); 
$branco = ImageColorATlocate(Simagem, 255, 255, 255); 
Sponto = array( 

150, 10, 

190, 120, 

290, 120, 

210, 180, 

255, 290, 

150, 220, 

45, 290, 

90, 180, 

10, 120, 

110, 120 
); = 
ImageFilledfolygon($imagem, $pontos, 10, $branco}; 
ImagePng($imagem}); 
ImageDestroy($imagem) ; 
7> 


Nosso array de pontos contém agora vinte elementos, para representar os dez 
pontos da estrela. A figura 7.5 mostra a imagem que você irá visualizar ao abrir a 
página estrela.php no navegador. 


Esse programa pode ser modificado para desenhar qualquer tipo de polígono. 
Porém, ao acrescentar ou retirar pontos do array, não se esqueça de alterar o terceiro 
parâmetro da função ImagePolygon ou ImageFiTtedPolygon, que corresponde ao número de 
pontos (ou vértices) do polígono. As linhas são traçadas na ordem em que os pontos 
foram especificados, e a última linha liga o último ponto do array ao primeiro. 
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Figura 7.5 — Desenhando um poligono com preenchimento. 


Arcos 


Um arco é uma elipse ou um círculo parcial, isto é, um segmento de uma dessas 
figuras. No PHP, para desenhar um arco, utiliza-se a função ImageArc, que possui a 
seguinte sintaxe: 


int Tmageárc (recurso imagem, int cx, int cy, int largura, int altura, int ang_inicio, 
int ang fim, int cor) 


Parâmetro Descrição 

imagem Identificador da imagem retornado pela função ImageCreate. 

EX Coordenada x do centro da elipse ou círculo parcial que será desenhado. 
cy Coordenada y do centro da elipse ou círculo parcial que será desenhado. 
largura Largura, em pixels, da elipse ou círculo. 

altura Altura, em pixels, da elipse ou círculo. 

ang-inicio Ângulo, em graus, a partir do qual o arco começará a ser desenhado. 
ang fim Ângulo, em graus, no qual o arco deve terminar. 

cor Identificador da cor que será usada para desenharoarco. Esse identificador 


deve ter sido retornado previamente pela função ImageColorAllocate. 


Imagine que o ângulo 0º corresponde ao número 3 em um relógio de ponteiros 
e o arco será desenhado em sentido horário. Acompanhe o programa arco.php: 
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arco. php 


<?php 

header{"Content-type: image/png"); 

$imagen = ImageCreate(300, 300); 

$branco = ImageCtolorATIocate(Simagem, 255, 255, 255); 
Svermelho = ImageColorAJlocate(fimagem, 255, O, 0); 
ImageArc(Simagem, 150, 150, 300, 300, O, 180, $vernelho); 
ImagePng(Simagem) ; 

ImageDestroy(Simagem); 

?> 


Criou-se uma imagem de 300x300 pixels e nela se desenhou um arco na cor 
vermelha. Esse arco foi centralizado exatamente no meio da figura, no ponto 
(150,150), e suas medidas (largura e altura) são iguais às da figura, 300x300 pixels. 
Definimos o ângulo inicial como sendo 0º e o final como 180º. Isso significa que 
estamos desenhando um arco que corresponde à metade de uma circunferência, 
como podemos observar na figura 76. 


Se tivéssemos definido o ângulo final como 360º, seria desenhado um círculo 
completo. Inclusive, nas versões mais antigas da biblioteca, a função ImageArc era 
usada para desenhar círculos e elipses. Atualmente essa função é mais utilizada 
para gerar arcos, pois já existe uma função específica para gerar círculos e elipses, 
como veremos no próximo tópico. 


Figura 7.6 — Desenhando um arco. 
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Circulos e elipses 


A partir da versão 406 do PHP, introduziu-se a função Imagefl lipse para desenhar 
círculos e elipses. Sua sintaxe é apresentada a seguir. 


int ImageEllipse (recurso imagem, int cx,int cy,int largura,int altura int cor) 


Parâmetro Descrição 

imagem Identificador da imagem retornado pela função ImageCreate. 

cx Coordenada x do centro da elipse ou círculo que será desenhado. 

cy Coordenada y do centro da elipse ou círculo que será desenhado. 
Targura Largura, em pixels, da elipse ou círculo. 

altura Altura, em pixels, da elipse ou círculo. 

cor Identificador da cor queserá usada pata desenhar o arco. Esseidenhificador 


deve ter sido retornado previamente pela função ImageColorAT locate. 


Veja que a sintaxe é parecida com a da função ImageArc. Foram eliminados apenas 
os dois parâmetros correspondentes aos ângulos de início e fim, visto que para de- 
senhar uma elipse ou um círculo o ângulo será sempre de 360º. Acompanhe agora 
o próximo exemplo, nomeado como elipse.php: 


elipse php 


<?php 

header("Content-type: image/png"); 

$imagem = ImageCreate(300, 300); 

branco = ImageColorAlIocate(Simagem, 255, 255, 255) 
fazul = ImageColoraTiocate(Sinagem, O, O, 255); 
ImageEWipse CSimagem, 150, 150, 290, 150, Sazul); 
ImagePng(Simagem) ; 

ImageDestroy(Simagem); 

?> 


Esse programa desenha uma elipse em azul, centralizada no ponto (150,150), com 
diâmetro horizontal (largura) igual a 290 pixels e diâmetro vertical (altura) igual a 
150 pixels. Ao abrir a página no navegador, você verá a tela mostrada na figura 7.7. 
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Figura 7.7 — Desenhando uma elipse. 


Para desenhar um círculo, o procedimento é praticamente o mesmo. A única 
diferença consiste em utilizar valores iguais para os dois diâmetros. Por exemplo: 


circulo.php 


<?php 

header("Content-type: image/png"); 

Simagen = ImageCreate(200, 300); 

branco = ImageColorATIocate(Sinagem, 255, 255, 255): 
Sazul = ImageColorATIocate(Simagem, 0, O, 255); 
ImageElipse (Simagem, 150, 150, 295, 295, azul); 
ImnagePng(Fimagen); 

ImageDestroy(fimagem); 

7> 


Esse programa desenha um círculo em azul, centralizado no ponto (150,150) e 
com diâmetro de 295 pixels. Visualizando o resultado no navegador, você verá a 
tela mostrada na figura 78. 


Assim como a função que desenha retângulos, a ImageEllipse também desenha 
apenas a borda da figura, deixando-a sem preenchimento. Para desenhar uma elipse 
ou um círculo preenchido com uma determinada cor, basta substituir a função 
ImgeElTipse pela ImageFilledENipse, que recebe exatamente os mesmos parâmetros. 
Como exemplo, considere o programa sorri so. php, em que vamos criar uma ima- 
gem e desenhar nela alguns círculos preenchidos para representar um rosto. Para 
desenhar a boca, será usada a função que vimos no tópico anterior para desenhar 
arcos. Acompanhe o programa e, logo a seguir, as explicações. 
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Figura 7.8 — Desenhando um círculo. 


sorriso.php 


<?php 

header ("Content-type: image/png"); 

Simagem = ImageCreate(300, 300); 

/f aloca as cores 

branco = InageColorATocate(Simagem, 255, 255, 255); 
iverde = ImageColorANocate(Simagem, O, 255, 0; 
amarelo = ImageColorAllocate($imagem, 255, 255, 0); 
Sazul = ImageColorAVocate(Simagem, O, 0, 255); 

/! desenha o rosto 

ImageFilledETlipse ($imagem, 150, 150, 295, 295, verde); 
ImageEliipse (Simagem, 150, 150, 295, 295, fazul); 

4! desenha os olhos 

ImagefilledEllipse (Simagem, 90, 90, 30, 30, Samarelo); 
ImageEllipse CSimagem, 90, 90, 30, 30, fazul); 
ImageFilledEllipse CSimagem, 210, 90, 30, 30, tamarelo); 
ImageEllipse (Simagem, 210, 90, 30, 30, $azuł); 

!! desenha o nariz 

ImagefilledEllipse (Simagem, 150, 150, 20, 20, Samarelo); 
ImageEllipse CSimagem, 150, 150, 20, 20, Sazul); 

// desenha a boca 

ImageArc(Simagem, 150, 160, 200, 150, 0, 180, Sazul); 

ff envia a imagem 

InagePng(Fimagem); 

InageDestroy(timagem); 

7> 
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Note que para cada círculo preenchido desenhado com a função ImageFi edeWip- 
se, foi desenhado um outro círculo, na mesma posição com as mesmas dimensões, 
utilizando a função ImageENipse. Isso foi feito para que o círculo apresentasse uma 
cor no preenchimento e outra na borda. À cor azul foi utilizada em todas as bor- 
das. O círculo maior, representando o rosto, foi preenchido com a cor verde e os 
demais, com a cor amarela. Abrindo a página sorriso.php no navegador, você verá a 
tela mostrada na figura 79. 
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Figura 7.9 — Desenhando círculos com preenchimento. 


Veja que para representar a boca, desenhou-se o arco de uma elipse cujo centro 
é o ponto (150,160), a largura é 200 pixels e a altura, 150 pixels. Para desenhar o 
círculo que representa o nariz, tomou-se como referência o ponto central do círculo 
maior, o (150,150). Para definir as coordenadas dos demais círculos que representam 
os olhos, reduziu-se o valor da coordenada y para 90 (para desenhar mais acima). O 
valor da coordenada x foi reduzido para desenhar o primeiro olho mais à esquerda 
e, logo após, aumentado para desenhar o outro olho mais à direita. 


Escrevendo em uma imagem 


Agora que você já aprendeu a desenhar os elementos gráficos básicos, vamos ver 
como inserir textos dentro de uma imagem usando o PHP. Para escrever um texto, 


Capítulo 7 » A arte de gerar imagens no PHP 179 


podemos utilizar a fonte-padrão ou, então, fontes externas. Neste tópico, veremos 
como desenhar com a fonte-padrão e também com fontes do tipo TrueType. 


Usando a fonte-padrão 


A biblioteca de funções de imagens do PHP nos permite desenhar textos em uma 
imagem de dois modos: horizontal ou vertical. A função ImageString é a responsável 
por desenhar textos na horizontal e sua sintaxe é apresentada a seguir: 


int ImageString (recurso imagem, int fonte, int x, int y, string texto, int cor) 


Parâmetro Descrição 


imagem Identificador da imagem retornado pela função ImageCreate. 


fonte Identificador da fonte que será usada para escrever o texto. Os valores de 
la 5 indicam que se deve usar a fonte-padrão, 

x Coordenada x do ponto a partir do qual o texto será escrito. 

y Coordenada y do ponto a partir do qual o texto será escrito. 

texto Texto que será escrito na imagem. 

cor Identificador da cor que será usada para desenhar o arco. Esse identificador 


deve ter sido retornado previamente pela função ImageColorATIocate. 


O segundo parâmetro da função ImageString corresponde ao tipo de fonte que 
será utilizado. A fonte-padrão possui cinco tamanhos diferentes, representados pe- 
los valores 1, 2, 3, 4 e 5. O valor 1 representa o menor tamanho, enquanto o valor 5, 
o maior. Valores maiores que 5 são reservados a fontes externas, carregadas com a 
função ImageLoadFont. Como exemplo, acompanhe o programa texto.php, que escreve 
um texto branco em uma imagem de tundo azul: 


texto.php 


<?php 

header ("Content-type: image/png"); 

fimagem = ImageCreate(200,40); 

Sazul = ImageColorATlocat(Siragem, O, O, 255); 

$branco = ImageColorATIocate(Simagem, 255, 255, 255); 
ImageString(Simagem, 5, 3, 3, "Juliano Niederauer”, $branco); 
ImagePng(Fimagem); 

ImageDestroy (Simagem); 

% 


Nesse exemplo, utilizou-se uma fonte-padrão de tamanho 5 para escrever o texto 
“Juliano Niederauer” a partir do ponto (3,3) da imagem. A imagem resultante obtida 
ao executar o programa é apresentada na figura 710. 
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Figura 7.10 — Escrevendo em uma imagem. 


Em vez de ser escrito da esquerda para a direita, esse mesmo texto pode ser 
escrito também na vertical, de baixo para cima. A função responsável por escrever 
textos na vertical é a ImageStringUp, que possui exatamente os mesmos parâmetros da 
função ImageString. Como exemplo, observe o programa texto vertical.php: 


texto vertical.php 


<?php 

header("Content-type: image/png"); 
$imagem = ImageCreate (40,200); 
famarelo = ImageColorANocate(Simagem, 255, 255, 0); 

preto = IitageColorATiocate(Simagem, O, 0, 0); 
ImageStringUpCtimagem, 5, 10, 190, “Juliano Niederauer”, Spreto); 
ImagePng(Simagenm) ; 


InageDestroy(Sinagem); 
?> 


Nesse exemplo, como o texto é desenhado na vertical, invertemos as dimensões 
das imagens utilizadas no exemplo anterior. Em vez de 200x40 pixels, a imagem 
é criada com as dimensões de 40x200 pixels. O valor da coordenada y (terceiro 
parâmetro da função) deve ser alto porque o texto começará a ser escrito na parte 
inferior da imagem. O programa texto vertical.php cria uma imagem com fundo 
amarelo e escreve o texto “Juliano Niederauer” na vertical, usando a cor preta. À 
figura 711 mostra o resultado obtido. 
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Figura 7.11 — Escrevendo um texto na vertical. 


Usando fontes TrueType 


e 


Outra maneira de escrever em uma imagem é utilizando fontes do tipo TrueType. 
Normalmente encontramos essas fontes em nosso diretório do Windows salvas em 
arquivos com extensão .ttf. Na internet, também existem diversos sites onde você 
pode fazer os downloads de diferentes tipos de fontes. A função do PHP que escreve 


utilizando fontes True Type é a InageTtfText, cuja sintaxe é apresentada a seguir: 


array ImageTtfText (recurso imagem, int tamanho, int ângulo, int x, int y, int cor, 
string arquivo fonte, string texto) 


Parâmetro Descrição 

imagem Identificador da imagem retornado pela função ImageCreate. 

tamanho Tamanho da fonte. 

ângulo Ângulo que define a inclinação com a qual o texto será escrito. O 
valor O indica que o texto será escrito na horizontal. 

x Coordenada x do ponto a partir do qual o texto será escrito, 

y Coordenada y do ponto a partir do qual o texto será escrito. 

cor Identificador da cor que será usada para desenhar o arco. Esse 


arquivo_fonte 


texto 


identificador deve ter sido retornado previamente pela função 
ImageColorAl locate. 


Arquivo onde está localizada a fonte que será usada para escrever 
O texto. 


Texto que será escrito na imagem. 
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Ao contrário da função ImageString, as coordenadas definidas pelos parâmetros 
x e y representam a posição do canto inferior esquerdo do primeiro caractere do 
texto. À função ImageTtfText retorna um array de oito elementos, que representam os 
quatro pontos que determinam os limites do texto. 


O primeiro ponto representa o canto inferior esquerdo, o segundo, o canto inferior 
direito, o terceiro, o canto superior direito, e o quarto, o canto superior esquerdo. 
Esses pontos referem-se somente ao texto, não considerando a inclinação definida 
pelo ângulo fornecido. Isso significa que os limites referem-se ao texto desenhado 
na posição horizontal. Para entender como funciona a função, considere o exemplo 
fonte.php: 


fonte.php 
<?php 
header("Content-type: image/jpeg"); 
$fonte = "/windows/fonts/impact. ttf"; 
imagem = ImageCreate(400,70); 
famarelo = ImageColorAlTocate(Simagem, 255,255,0); 
$preto = ImageColorANocate(Simagem, 0,0,0); 
ImageTtfText (imagem, 24, 10, 70, 65, fpreto, Sfonte, “Juliano Niederauer"): 
ImageJpeg(Simagem); 
InageDestroy(Himagen) ; 
?> 


Esse exemplo utiliza uma fonte True Type.chamada Impact, localizada no diretório 
de fontes do Windows. Caso você queira utilizar alguma fonte TrueType obtida na 
internet, basta modificar o valor da variável $fonte, especificando o diretório onde a 
fonte foi salva, assim como o nome do arquivo .ttf. O programa fonte.php cria uma 
imagem com fundo amarelo, nas dimensões de 400x70 pixels, e escreve o texto 
“Juliano Niederauer” em preto, utilizando a fonte Impact de tamanho 24 e com 10º 
de inclinação. A imagem resultante é apresentada na figura 712. 


Caso o PHP não reconheça a função InageTtfText, é possível que esteja faltando 
alguma biblioteca em seu sistema. O manual do PHP enfatiza que essa função re- 
quer, além da GD, uma biblioteca adicional chamada FreeType, que pode ser obtida 
gratuitamente no endereço http://www. freetype.org/. 
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Figura 7.12 — Utilizando fontes TrueType. 


Exemplos de aplicações 


Chegou o momento de colocar em prática os conhecimentos que você adquiriu 
no decorrer deste capítulo. Afinal, desenhar círculos, quadrados, retângulos ou 
polígonos na web é muito bonito, mas praticamente não há utilidade alguma 
em desenhar essas figuras de forma isolada. E como este livro tem o objetivo de 
apresentar exemplos que realmente serão úteis a seu website, veremos a partir de 
agora algumas aplicações que podem ser criadas com as funções apresentadas nos 
tópicos anteriores e com outras funções que manipulam imagens. Utilizando sua 
criatividade, você poderá criar os mais variados tipos de aplicações para trabalhar 
com imagens. A seguir, serão apresentados alguns exemplos úteis. 


Contador de visitas gráfico 


Muitos webmasters gostam de exibir um contador de visitas em seu website, para 
mostrar aos visitantes quantos acessos o website já recebeu. Esses webmasters po- 
dem utilizar o PHP para criar um contador de visitas próprio, em formato gráfico. 
Como vimos no início deste capítulo, a criação de um contador próprio evita que 
tenhamos que utilizar programas de terceiros. Existem três vantagens em ter um 
contador próprio. Veja-as a seguir: 


t. O script estará localizado em seu próprio servidor. Isso fará que o contador 
seja exibido de forma mais rápida, visto que não haverá necessidade de abrir 
uma conexão com outro servidor. 
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2. O contador será exibido sempre. Isso pode não ocorrer se você estiver utili- 
zando um contador externo, já que o servidor do fornecedor do script poderá 
ficar temporariamente fora do ar em razão de algum problema técnico. 


3. Não haverá propagandas vinculadas a seu contador. Muitos websites que ofe- 
recem um contador gratuito acabam fornecendo-lhe um código que vincula 
algum tipo de propaganda ao contador que será exibido em seu website. 


Ao criar um contador, é fundamental decidir o local onde ficará armazenado 
seu valor. Você poderá escolher uma das seguintes opções: 


* gravar o valor em um arquivo-texto; 
-= gravar o valor em um banco de dados. 


Nesse tópico, veremos como implementar as duas formas, para que você possa 
escolher qual delas melhor se adapta a seu website. A tabela a seguir mostra as 
vantagens e desvantagens de cada uma. 


Primeiramente, veremos como implementar o contador gráfico armazenando 
seu valor em um arquivo-texto, que chamaremos de contador. txt. Logo após, será 
mostrado como alterar o programa para armazenar esse valor em um banco de 
dados MySQL. 


Antes de criar o programa PHP vamos criar um arquivo HTML simples, contendo 
somente uma chamada para o contador. O código desse arquivo, nomeado como 
contador .html, é apresentado a seguir: 


contador.himl 


<html> 

<head> 

«title>Livro de PHP - Contador Grafico</title> 
</head> 

<body> 

<p align="center">Número de acessos: </p> 

<p align="center"><img src="contador.php"></p> 
</body> 

</html> 


Repare que o contador foi chamado como se fosse uma imagem. Isso significa 
que o programa contador .php, que será apresentado logo em seguida, deverá retornar 
uma imagem ao navegador. Como vimos anteriormente, nesses casos o script deve 
conter o comando header para informar ao navegador o tipo de conteúdo que será 
retornado. 
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Vamos agora analisar o programa contador .php, responsável por acessar O valor atual 
do contador, incrementá-lo e exibir, em forma de imagem, o novo valor. Esse programa 
utiliza um arquivo-texto para armazenar o valor do contador. Acompanhe o código, 
que já contém alguns comentários, e logo após as explicações detalhadas: 


contador. php 


<?php 

// cores e dígitos 
Scor fundo = "preto"; 
Scor fonte = "branco"; 
fcor borda = "verde"; 
fdigitos = 7; 
// dimensões do contador 
$x = 54; 

ty = 14; 

/f tamanho da fonte 
$fonte = 3; 

// define as margens 
margem x = 3; 

margem y = 0; 


// chama função que retorna o próximo valor do contador 
Scontador = RetornaProximoValor(Sdigitos); 


J1 informa ao navegador o tipo de imagem que será retornado 
header ("Content-type: image/png"); 

ff cria a imagem 

Simagem = ImageCreate($x,$y); 

/! define as cores 

branco = ImageColorATocate(finagem,255,255,255); 
preto = ImageColorATiocate(Simagem,0,0,0); 

verde = ImageColorANocate(Simagem,0,255,0); 
vermelho = ImageColorATocate (imagem, 255,0,0); 
$azul = ImageColorAl locate($imagem, 0,0,255); 
amarelo = ImageColorAllocate($imagem, 235,255,0); 


4! obtém o identificador das cores escolhidas 
tcor. fundo = Sfcor fundo; 
Scor fonte = $$cor fonte; 
cor. borda = $fcor borda; 


// desenha um retângulo com a cor do fundo 
ImageFilledRectangieCSimagem,0,0,3x, $y, Scor fundo); 

+i desenha a borda 

inageRectangle(Simagem, 0,0,8x-1,3y-1,8cor- borda); 

/f escreve o valor atual do contador 

InageString(Simagem, $fonte, imargem x, margem y, $contador, $cor fonte); 
// gera a imagem PNG a ser enviada ao navegador 

ImagePNGCSimagem) ; 
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/f Vibera a memória utilizada 
ImageDestroy(Simagem); 


function RetornaProximovalor (Sdigitos) 
{ 
ff arquivo onde será armazenado o valor do contador 
arquivo = "contador. txt"; 
/f abre o arquivo e lê o valor atual 
if (file exists(Sarquivo)) 
{ 
Sponteiro = fopen (Sarquivo, "rJ; 
fvalor = fgets($ponteiro, 4096); 
fclose CSponteiro); 
l 
else 
valor = O; 
fvalor+; 
// grava o novo valor no arquivo 
tponteiro = fopen (Sarquivo, "w"); 
flock ($ponteiro, LOCK EX): 
fwrite(Sponteiro, "$valor"); 
flock (Sponteiro, LOCK UN): 
fclose (fponteiro); 


while (strlentivalor) < Sdigitos) 
$valor = "0" .$valor; 
return fvalor; 


} 


T> 


Vamos analisar os principais trechos do programa contador. php. Inicialmente, defi- 
nimos as cores do contador por meio das variáveis $cor fundo, $cor fonte, $cor. borda: 


$cor fundo = "preto"; 
fcor fonte = "branco"; 
$cor borda = "verde"; 


» 


Note que as palavras “preto” “branco” e “verde” são simples textos, mas poste- 
riormente serão usadas para acessar os valores das variáveis que receberão os iden- 
tificadores retornados pela função ImageColtorAl locate. Você pode alterar à vontade 
as cores de seu contador, mas lembre-se de que só poderá utilizar os nomes das 
cores que serão definidas logo a seguir no programa. Em nosso exemplo, você pode 


» EL 


verde” “vermelho” 


Doi 3 K 


utilizar qualquer um dos seguintes valores: “branco” “preto” 
“azul” ou “amarelo” 


No início do programa também definimos, por meio da variável $digitos, o 
número de dígitos que o contador deve possuir. Em nosso exemplo, o valor do 
contador será exibido com 7 dígitos. As três próximas variáveis do programa são 
$x, $y e Sfonte, que representam, respectivamente, a largura (em pixels) do contador, 
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a altura (em pixels) do contador e a fonte a ser utilizada para escrever seu valor. Por 
exemplo, se você aumentar o número de dígitos, provavelmente terá de aumentar 
também a largura do contador, ou seja, a variável $x- 


A variável margem x define a distância da lateral da imagem até o início do texto, 
enquanto a variável $margem y define a distância do topo da imagem até o início do 
texto. Ambos os valores devem ser expressos em pixels. 


Logo após, é chamada a função RetornaProximovalor, que foi definida mais adian- 
te. Essa função acessa um arquivo-texto chamada contador. txt, obtém o valor nele 
gravado, incrementa-o, grava o novo valor no arquivo e o retorna para o ponto do 
programa que ativou a função: 


Scontador = RetornaProximoValor(Sdigitos); 


A variável $contador irá armazenar esse novo valor, que posteriormente será escrito 
na imagem. Note que você não precisa preocupar-se se o arquivo contador .txt existe 
ou não, pois dentro da função é testada a existência desse arquivo com a função 
file exists, 


Caso não exista (o que ocorrerá no primeiro acesso), O valor será definido como 
zero e o arquivo será criado no momento da gravação. Um detalhe importante é 
verificar se o diretório onde será gravado o arquivo contador. txt possui permissão de 
escrita, caso contrário poderá ocorrer um erro na gravação. Portanto, se o diretório 
corrente não tiver essa permissão, você deverá atribuí-la a ele. Outra opção é criar 
um novo diretório com permissão de escrita e alterar o valor da variável farguivo 
para que o contador .txt seja criado nesse novo diretório. 


Ainda dentro da função RetornaProximovalor, veja que se utilizou a função flock para 
implementar um controle de concorrência no arquivo contador.txt. Dessa forma, 
não ocorrerá perda de dados caso vários processos (referentes aos vários visitantes 
de seu site) tentem realizar simultaneamente a gravação nesse arquivo. Ao final da 
função RetornaProximoValor, cria-se um laço while para formatar o valor de acordo com 
o número de dígitos especificado no início do script. Isso é feito adicionando-se 
zeros à esquerda do número, até que este atinja o tamanho desejado. 


Prosseguindo com a análise do código principal do programa contador. php, Os 
próximos passos são basicamente aqueles que você aprendeu no decorrer deste ca- 
pítulo, ou seja, a criação da imagem, definição das cores e do conteúdo da imagem 
(que nesse caso é um texto com o valor da variável $contador e mais dois retângulos: 
um para a cor de fundo e outro para a borda), o envio da imagem ao navegador € 
a liberação da memória. 
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Um trecho que talvez seja novidade para você é aquele que vem logo após a 
definição das cores com a função ImageCollorANocate: 


$cor. fundo = $fcor fundo; 
Scor fonte = $fcor fonte; 
$cor. borda = $$cor borda; 


Essa criação dinâmica de nomes de variáveis foi feita para obter o identificador 
da cor que você definiu (como um simples texto) no início do script. O objetivo 
foi concentrar no início do script todas as variáveis de configuração, pois não seria 
interessante ter de percorrer todo o programa para ver quais os trechos que podem 
ser modificados. 


+ 


Então, por exemplo, se você definiu no início a variável $cor fundo como “preto” 
P 

os dois cifrões ($$) indicarão que agora a variável $cor_fundo receberá o conteúdo 

da variável $preto. 


Veja agora o resultado obtido. Ao abrir a página HTML no programa navegador, 
você verá um contador com fundo preto, texto branco e borda verde, como mostra 
a tela apresentada na figura 713. 


Número de acessos: 


Figura 7.13 — Contador de visitos em formato gráfico. 


Pronto! Você já tem um contador de acessos próprio, em formato gráfico, para 
exibir a seus usuários de seu website. Para finalizar, veremos agora o que deve ser 
feito caso queira armazenar o valor do contador em um banco de dados em vez de 
utilizar um arquivo-texto. 


Como exemplo, vamos utilizar um banco de dados MySQL. Para fazer seu con- 
tador funcionar com o MySQL, você precisa seguir dois passos. O primeiro consiste 
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em criar uma tabela com um único campo para armazenar o valor do contador. Por 


exemplo, abra o utilitário mysql e digite: 


create table contador 


( 


J; 


valor int NOT NULL 


O segundo passo é substituir, no programa contador. php, a função RetornaProximovalor 


pela apresentada a seguir. Essa função acessa o valor do contador através de uma 
conexão com o servidor MySQL, em vez de acessar um simples arquivo-texto. Você 
deve alterar as quatro primeiras variáveis dessa função, de acordo com a configuração 
de seu servidor. Especifique o endereço de seu servidor, o nome de usuário, senha 


e o nome do banco de dados no qual você criou a tabela contador: 


function RetornaProximoValor (Sdigitos) 


{ 


} 


$servidor = "localhost" 

usuario = "juliano"; 

$senha = "12345"; 

banco = "bdteste"; 

$con = mysgl. connect(Sservidor, $usuario, $senha) ; 
mysql select db ($banco); 

$result = mysql. query("select * from contador"); 
itotal = mysql num rows($resuit); 

if (Stotal > 0) 


T 

Svalor = mysql_result($result, 0,0); 

$valor++; 

$result = mysql_query("update contador set valor=$valor"); 
J 
else 
{ 

$valor = 1; 

$result = mysql. query("insert into contador values (1)”); 
H 


mysql. close(fcon); 


while Cstrlen($valor) < Sdigitos) 
valor = "0" .$valor; 
return Svalor; 


Veja que no primeiro acesso, como a tabela contador estará vazia, a função irá in- 


cluir um registro com o valor 1 e, nas próximas vezes, será feita apenas a atualização 


desse valor. A imagem resultante é exatamente igual àquela gerada pelo método que 
utiliza um arquivo-texto. A diferença está somente no modo de armazenamento do 
valor do contador. 
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Marcador de imagens para websites 


É comum encontrarmos websites exibindo alguns tipos de imagens (figuras ou fotos) 
próprias, gravando no canto dessas imagens um texto indicando que pertencem a 
esse website. Um exemplo são os sites de cartões, que gravam sua marca no canto das 
imagens. Outro exemplo que pode ser citado são os sites de humor que publicam 
charges e gravam em cada uma delas um texto indicando que a charge pertence a 
eles. Observe a figura 714. 


Figura 7.14 — Charge em um site de humor. 


Veja que, no canto inferior esquerdo da imagem, foi escrito o nome do site ao 
qual esta pertence. Pode-se citar ainda um conhecido website americano que tem 
por objetivo publicar fotos de pessoas feias (sim, alguém perdeu tempo fazendo isso). 
No canto de cada foto publicada é gravado o endereço do website (wm.uglypeople. 
com). Assim se identifica a origem da foto, caso alguém copie essas imagens e envie- 
as para algum amigo. 


Enfim, independentemente do tipo de website que você tem, se houver necessi- 
dade de gravar alguma informação nas imagens que possui, essa técnica poderá ser 
utilizada. Você pode estar pensando: “Mas isso é muito fácil de fazer! Basta abrir 
a imagem em um programa gráfico qualquer e inserir o texto que eu quiser!” Mas 
pense bem: não seria melhor se isso fosse feito de forma automática? O PHP serve 
para isso! Ele nos permite criar não só páginas dinâmicas, mas também criar e/ou 
modificar imagens dinamicamente. 


Se o PHP pode automatizar o processo, então por que perder tempo procurando 
um editor gráfico, escolhendo tipos e tamanhos de fontes, posicionando os textos 
nos locais adequados e salvando a imagem? Deixe que o PHP faça tudo para você. 
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Não é necessário sequer ter um editor gráfico instalado em sua máquina. As funções 
de manipulação de imagens do PHP farão todo o trabalho do editor. 


Como exemplo, veremos como criar um programa que abre uma imagem JPEG 
e grava um determinado texto sobre esta. Observe o código do programa foto.php 
apresentado a seguir. Esse programa abre uma imagem e escreve, em um ou mais 
cantos dela, um texto qualquer escolhido por você. Acompanhe o código e, logo 
após, as explicações: 


foto.php 


<?php 
/! variáveis de configuração 
Simagen = "foto. jpg"; 
ftexto = "http://www. niederauer. com.br"; 
$fonte = 3; 
flargura fonte = 7; 
Saltura fonte = 11; 
jmargem x = 3; 
margem y = 3; 
!! O=não exibe, 1=exibe 
fsuperior esquerdo = O; 
Ssuperior direito = 0; 
finferior esquerdo = 1; 
$inferior direito = 0; 
ii ERASKALLERLSESHASKALARAA TIA AESA RR 
if Clfile exists(Simagem)) 
{ 
echo "Arquivo da imagem não encontrado!”; 
exit; 
} 
// define largura e altura do texto em pixels 
$largura_texto = strlenć$texto)*$largura_fonte + 2*$margem_x; 
faltura texto = faltura fonte + 2*$margem_y; 
// monta o nome do arquivo resultante 
Sarquivo resultante = explode('.', imagem), 
tarquivo resultante = Sarquivo resultante[0]." escrito. jpa"; 


!! Tê a imagem de origen e obtêm suas dimensões 
Simagem origem = ImageCreateFromJPEG(Simagem) ; 
Sorigem x = ImagesX(Simagem origem)-1; 
torigem y = ImagesY(Simagem origemn)-1; 


/t! define as cores 
branco = ImageColorAliocate(fimagem origem, 255, 255, 255); 
Sazul = ImageColorAlocate(Simagem origem, 0, O, 255); 
!f escreve o texto nos cantos especificados 
if (fsuperior. esquerdo) 
{ 
ImageFiiledRectangle(timagem origem, O, O, $largura_texto, $altura_texto, $azul); 
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TrnageString(Simagem origem, $fonte, fmargem x, $margem y, Stexto, $branco); 


k 
if (superior direito) 
{ 
ImageFiltedRectangte(Simagem origem, Sorigem x-Siargura texto, O, Sorigem x, 
Saltura texto, azul); 
ImageString(Simagem origem, $fonte, forigem x-Slargura textorimargem x, 
imargem y, $texto, branco}; 
} 
if ($inferior_esquerdo) 
{ 
ImageFi HedRectangle($imagem origem, O, $origem_y-$altura_texto, $largura texto, 
torigem y, $azul); 
Inagestring(Simagem origem, Sfonte, Smargem x, forigem y-faltura texto+imargem. y, 
Stexto, $branco); 
} 
if ($inferior_direito) 
{ 
ImageFilledRectangle($imagem origem, $origem_x-$largura_texto, 
$origem_y-$altura_texto, $origem_x, $origem y, Sazul): 
ImageString($imagem_origem, $fonte, $origem_x-$largura_texto+$margem_x, 
forigem y-Saltura textorfmargem y, $texto, $branco); 
F 


ff salva a nova imagem 
ImageJPEG(Simagem origem, farquivo resultante); 
ff! Nibera a memória 


ImageDestroy(Simagem origem); 

?> = 

<html> 

<head> 

<title>Arquivo resultante</title> 

</head> 

<body><h2 align="center"><u>Arquivo resultante:</u> <?php echo $arquivo_resultante; 7></h2> 
<p align="center"><img src="<?php echo Sarquivo resultante; ?>"></p> 

</body> 

</html> 


Antes das explicações sobre os principais trechos desse programa, observe na 
Ç P B 

figura 715 o resultado obtido ao executá-lo no navegador. Foi escrito, no canto in- 

ferior esquerdo da imagem, o texto “http: //ww.niederauer. com.br” 


Em primeiro lugar, você já deve ter percebido que esse programa opera sobre uma 
imagem cujo nome é definido pela variável $imagem. Nesse caso, trata-se do arquivo 
foto. jpg, que deve estar no mesmo diretório do programa. O valor dessa variável 
foi fixado apenas para tornar o script mais simples e de fácil entendimento. Porém, 
você pode criar um formulário HTML para que o nome da imagem seja digitado 
ou inclusive utilizar os conhecimentos adquiridos no Capítulo 6 sobre uploads para 
que o arquivo a ser usado possa ser enviado a partir de um formulário. 
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Arquivo resultante: foto escrito. jpg 


Figura 7.15 — Imagem gerado pelo programa foto.php. 


Analisando os principais trechos do código, no início temos as variáveis de 


configuração da operação. Você pode alterá-las conforme sua necessidade. A seguir 


será apresentada uma descrição de cada uma delas. 


Variável 


Descrição 


$imagem 


$texto 


$fonte 


$largura_fonte 


faltura-fonte 


fmargen x 


$margem_y 


Nome do arquivo da imagem JPEG na qual será escrito o texto. 
Se o arquivo não estiver no mesmo diretório do programa PHP, 
indique o caminho completo (exs.: fotos/teste/foto. jpg). 


Texto que será escrito na imagem. Nesse exemplo será escrito o 
texto “http://www. niederaver . com.br”. 


Identificador da fonte que será utilizada para escrever o texto. 
Nesse exemplo, vamos utilizar a fonte-padrão de tamanho 3. 
Se você alterar o valor dessa variável, altere também as duas 
próximas variáveis. 

Largura, em pixels, da fonte escolhida. Em uma fonte-padrão 
de tamanho 3, cada caractere tem largura de 7 pixels. Se você 
alterar o tamanho da fonte, altere também essa variável para 
ajustar a largura desta. 


Altura, em pixels, da fonte escolhida. Em uma fonte-padrão de 
tamanho 3, cada caractere tem altura de L pixels. Se você alterar 
o tamanho da fonte, altere também essa variável para ajustar a 
altura desta. 


Define a margem horizontal, ou seja, a distância (em pixels) das 
laterais da figura até o texto, 

Define a margem vertical, ou seja, a distância (em pixels) dos 
limites superiores e inferiores da figura até o texto. 
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Variável Descrição (cont.) 


$superior esquerdo Se for definido o valor O (zero), o texto não será escrito no canto 
superior esquerdo da figura. 


$superior direito Se for definido o valor O (zero), o texto não será escrito no canto 
superior direito da figura. 


Sinferior. esquerdo Se for definido o valor O (zero), o texto não será escrito no canto 
inferior esquerdo da figura. 


tinferior direito Se for definido o valor O (zero), o texto não será escrito no canto 
inferior esquerdo da figura. 


Após a definição das variáveis de configuração, efetua-se um teste com a função 
file exists para verificar se o arquivo especificado realmente existe. Se não existir, a 
execução será encerrada. Logo a seguir serão calculadas as dimensões, em pixels, do 
texto a ser escrito. Para a largura, multiplica-se o número de carateres do texto pela 
largura da fonte. Somamos a esse valor a margem horizontal para os dois lados do 
texto, pois mais adiante iremos desenhar um retângulo em torno dele: 


Slargura texto = strlen(Stexto) * $largura fonte + 2 * Imargem x; 


Para calcular a altura, basta somar a altura da fonte com a margem vertical 
multiplicada por dois (superior e inferior): 


Saltura texto = faltura fonte + 2 * $margem y; 


Arquivo resultante: foto escrito.jpg 


[https /Zuuu ni eder aver. cua.br 


Figura 7.16 — Texto escrito nos quatro cantos da imagem. 
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Miniaturas (thumbnails) de imagens 


As miniaturas de imagens, também conhecidas como thumbnails, são bastante 
comuns na web. Normalmente são utilizadas para exibir amostras das imagens 
originais. Alguns webmasters, principalmente dos sites que publicam fotos na web, 
criam uma espécie de álbum de fotografias, onde o visitante pode clicar sobre a 
miniatura para ver a imagem em seu tamanho real. Veja na figura 717 um exemplo 
de um website que disponibiliza alguns papéis de parede para download, exibindo 
uma miniatura de cada um deles. 


y EE 
fon gare i PAPËN DE PASRER: 
st i 


Chque sobre ¢ papel de parede desejado para vé-lo no tamanho angina). É 
Pera defian lo como papel de parede de seu computador, digus com o botão 
É direito do cnouse sobra a imagem ampliada e escolha a opção “Osficur como 
plano de fundo”, Todos estão no fermata 10242768. 


~ carnaval 


Lo A Ets É 


figura 7.17 — Miniaturas de imagens. 


Outro exemplo que pode ser citado são as livrarias virtuais. Se você já acessou 
o site de alguma delas, provavelmente deve ter visto a capa de um livro em formato 
reduzido, acompanhada pela frase “Clique aqui para ampliar”. Veja um exemplo na 
figura 718. 


Existem duas formas de exibir miniaturas de imagens em uma página web. Uma 
delas é utilizar apenas HTML para exibir a imagem original em dimensões reduzi- 
das. Para isso, basta alterar os parâmetros de largura e altura (width e height) da tag 
<img>. Porém, esse não é o método ideal, pois o programa navegador irá receber a 
imagem em seu tamanho original e ainda terá que redimensioná-la. Essa pode ser 
uma operação custosa caso a imagem seja muito grande. 
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Figura 7.18 — Miniatura em uma livraria viniual. 


A outra forma consiste em gerar as miniaturas em arquivos separados. É aí que 
entra o PHP, pois a geração desses arquivos pode ser feita de forma automática, 
o que lhe pouparia um bom tempo e você nem precisaria ter um editor gráfico 
instalado em sua máquina. Veremos agora como criar um programa em PHP para 
realizar essa geração. 


O programa apresentado a seguir, O gera miniatura.php, cria uma imagem redu- 
zida a partir da imagem que você especificar, permitindo ainda que se determine 
se o tamanho da miniatura será fixo ou se será calculado como um percentual do 
tamanho da imagem original. Acompanhe o código e logo após as explicações: 


gera miniatura. php 


<?php 

/! define a imagem a partir da qual será gerada a minuatura 
Simagem = "miniaturas/gremio. jpg"; 

// configurações da miniatura 

$tamanho_fixo = "N"; ft 5 ou N 

Slargura fixa = 192; // usado somente com tamanho fixo=5 
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Jaltura fixa = 144; !f usado somente com tamanha fixo=S 
fpercentual = 40; /f usado somente com tamanho, fixo=N 
{i BRBUCSNAETSSESVASARTANRSSANTEASTEAANAE 


if (file exists(Fimagem)) 


{ 
echo "Arquivo da imagem não encontrado!”; 
exit; 
k 
if (ftamanho fixo == "N" && (Spercentual < 1 || Spercentual > 1000) 
{ 
echo "O percentual deve ser um número entre 1 e 100!"; 
exit; 
} 
// monta o nome do arquivo resultante 
Sarquivo miniatura = explode('.', $imagem); 


arquivo miniatura = Sarquivo miniatura[0]." mini.jpg"; 

ff Tê a imagem de origem e obtém suas dimensões 

timg origem = ImageCreateFromJPEG(Simagem); 

Sorigem x = ImagesX(fing origem); 

Sorigem y = ImagesY(Simg origem); 

!! se não for tamanho fixo, calcula as dimensões da miniatura 
if (Stamanho fixo == "5") 


{ 
$x = Slargura fixa; = 
$y = $altura_fixa; 
} 
else 
{ 
$x = intval CSorigem x * $percentual/100); 
$y = intval ($origem_y * $percentual/100); 
} 


ff cria a imagem final, que irá conter a miniatura 

Simg final = ImageCreateTrueColorCSx, $y); 

/{ copia a imagem original redimensionada para dentro da imagem final 
ImageCopyResampled(Simg final, $img origem, 0, 0, 0,0, $x+1, $y+L, Sorigemx, Sorigem y); 
ft salva o arquivo 

InageJPEG(Simg final, Sarquivo miniatura); 

/! Vibera a memória alocada para as duas imagens 

ImageDestroy(Simg origem); 

ImageDestroy($img. final); 

?> 

<html> 

<head> 

«title>Livro de PHP - Miniatura de imagem</title> 

</head> 

<body> 

<p align="center"> 

<img src="<?php echo Simagem, 7>"> 

ênhsp:;&nbsp; &nhsp;ênbsp; 

<img src="<?php echo Sarquivo miniatura; ?>"> 

</p> 
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<p align="center"> 

<b>Imagem original</b>: <?php echo Simagem.” (".Sorige x.” x ".$origem_y.")";?><br> 
<b>Miniatura gerada</b>: <?php echo farquivo miniatura.” (".$x." x ".$y.")";?> 

</p> 

</body> 

</html> 


Antes das explicações sobre os principais trechos desse programa, observe na 
figura 719 o resultado obtido ao executá-lo no navegador. Gerou-se uma miniatura 
da imagem gremio. jpg, cujas dimensões foram definidas com base em um percentual 
das dimensões da imagem original. 


Imagem origina). cometuras/gremo pg (640 x 480) 
Miniatura gerada mniaturasioremruo_ mou pg (256 x 192) 


Figura 7.19 — Resultado da geração da miniatura. 


Assim como no exemplo anterior (marcador de imagens), esse programa opera 
sobre uma imagem cujo nome é definido pela variável $Simagem. Nesse caso, trata-se do 
arquivo gremio. jpg localizado em um diretório chamado “miniaturas”. O valor dessa 
variável foi fixado apenas para tornar o script mais simples e de fácil entendimento. 
Porém, você pode criar um formulário HTML para que o nome da imagem seja digi- 
tado ou, inclusive, utilizar os conhecimentos adquiridos sobre uploads no Capítulo 
6, para que o arquivo a ser usado possa ser enviado a partir de um formulário. 


Analisando os principais trechos do código, no início temos as variáveis que 
irão determinar como a miniatura será gerada. Você pode alterá-las conforme sua 
necessidade. A seguir será apresentada uma descrição de cada uma delas. 
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Variável 


Descrição 


Simagem 


ftamanho. fixo 


Sargura fixa 


faltura fixa 


Spercentual 


Nome do arquivo JPEG a partir do qual será gerada a imagem re- 
duzida. Se o arquivo não estiver no mesmo diretório do programa 
PHP, indique o caminho completo. 


Deve conter o valor “S” ou “N? O valor “S” indica que para qualquer 
imagem especificada, a miniatura irá conter sempre as mesmas 
medidas, independentemente das dimensões da imagem original. 
O “N” indica que as dimensões da miniatura serão um percentual 
das dimensões da imagem original, ou seja, será feira uma redução 
proporcional. 


Largura (em pixels) da miniatura, caso você escolha gerá-la com 
tamanho fixo. Use essa variável somente se $tamanhe, fixo estiver com 
o valor “S” 


Altura (em pixels) da miniatura, caso você escolha gerá-la com 
tamanho fixo. Use essa variável somente se ftamanho, fixo estiver com 
o valor “S? 


Use essa variável somente se $tamanho fixo estiver com o valor “N” 
Deve ser um valor entre 1 e 100, representando o percentual do ta- 
manho da miniatura em relação ao tamanho da imagem original. 
No exemplo, definimos o valor 40, o que significa que a miniatura 
terá 40% do tamanho da imagem original. 


Após a definição das variáveis de configuração, efetua-se um teste com a função 
file exists para verificar se o arquivo especificado realmente existe. Se não existir, a 
execução será encerrada. O próximo teste valida, quando o tamanho não é fixo, o va- 
lor percentual escolhido, exibindo uma mensagem de erro caso este seja inválido: 


if ($tamanho fixo == "N" && ($percentual < 1 || percentual > 1003) 


Em seguida, define-se o nome do arquivo resultante, concatenando a string 
“ mini. jpg” ao nome original do arquivo. No exemplo, a imagem original gremio. jpg 


irá gerar uma imagem resultante com o nome de gremio mini. jpg: 


farquivo miniatura 
farquivo miniatura 


explode(".", Simagem); 
Sarquivo mimiatura[0]." mini jpg"; 


O próximo passo consiste em criar a nova imagem com a função ImageCreateFromJPEG, 


baseada no arquivo gremio.jpg, e obter suas dimensões. 


Como vimos no exemplo anterior, essa função cria uma imagem em memória 


a partir do arquivo recebido como parâmetro: 


fimg origem = ImageCreateFron]JPEG(Simagem); 
Sorigemn x = ImagesX(Simg origem); 
Sorigemn y = ImagesY($img origem); 
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Nesse ponto do programa, já temos em memória a imagem original. Agora deve 
ser criada a imagem miniatura. Para isso, primeiro calculamos suas dimensões. Se 
você optou por gerar uma miniatura com tamanho fixo, as dimensões (representadas 
por $x e $y) simplesmente receberão os valores fixos definidos no início do script, 
ou seja, o valor das variáveis $largura fixa e Saltura fixa. 


Caso contrário, as dimensões $x e $y serão calculadas com base no percentual 
que você definiu: 


$x 
$y 


intval CSorigem x * $percentual / 100); 
intval (Sorigem.y * $percentual / 100); 


1l 


A função intval retorna o valor inteiro da operação entre parênteses. Agora que 
já temos as dimensões da imagem final, basta criá-la da seguinte forma: 


gimg final = ImageCreateTruelolor(ix, $y); 


Veja que se utilizou a função ImageCreateTrueColor em vez da ImageCreate. Isso foi feito 
porque as imagens criadas com a função ImageCreate não suportam o grande número 
de cores utilizado no formato JPEG. Por essa razão, usamos a ImageCreateTrueColor 
para que a imagem resultante possa conter todas as cores da original. 


Agora que alocamos espaço em memória para a imagem resultante, basta copiar a 
imagem original para esse espaço, reduzindo-a para suas novas dimensões. A função 
ImageCopyResampled é responsável por realizar essa operação: 


ImageCopyResampled(Simg final, Simg origem, 0, 0, 0, O, $x+1, $y+1, Sorigem x, forigem y); 


Essa função realiza a cópia de uma porção retangular de uma imagem para 
outra. Para entender o que significa cada um dos parâmetros, observe a seguir a 
sintaxe dessa função: 


int InageCopyResampled (recurso img destino, recurso img origem, int destX, int destY, int 
origX, int origY, int dest. largura, int dest altura, int orig largura, int origaltura) 


Parâmetro Descrição 


img destino Identificador da imagem para onde a imagem será copiada. Esse 
identificador deve ter sido retornado previamente pela função que 
criou a imagem (no exemplo, ImageCreateTrueColor). 


Img..origem Identificador da imagem que será copiada. Esse identificador deve 


ter sido retornado previamente pela função que criou a imagem 
(no exemplo, ImageCreateFromIPEÇ). 


destX Coordenada x do ponto a partir do qual a porção copiada será 
inserida. 
destY Coordenada y do ponto a partir do qual a porção copiada será 


inserida. 
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Parâmetro Descrição (cont.) 

origX Coordenada x do ponto a partir do qual a cópia será feita. 

origY Coordenada y do ponto a partir do qual a cópia será feita. 

dest largura Largura, em pixels, que a porção copiada terá na imagem destino. 
dest altura Altura, em pixels, que a porção copiada terá na imagem destino. 
orig largura Largura, em pixels, da porção a ser copiada na imagem origem. 
origaltura Altura, em pixels, da porção a ser copiada na imagem origem. 


Por fim, a imagem resultante é gravada no arquivo destino cujo nome defini- 
mos anteriormente (no exemplo, gremio. mini.jpg) e a memória alocada para as duas 
imagens é liberada: 


ImageJPEG(Simg. final, farquivo miniatura); 
ImageDestroy(Simg origem); 
InageDestroy(Simg final); 


Para visualizar o resultado, ao final da página utilizamos um código HTML para 
simplesmente exibir as duas imagens, uma ao lado da outra. 


Pronto! Agora você tem um programa que gera miniaturas para suas imagens. 
Utilize essas miniaturas (thumbnails) em seu site da forma que desejar. Por exem- 
plo, se você quiser exibir fotos em seu site, poderá criar uma espécie de álbum de 
fotografias, exibindo as miniaturas com links para as imagens originais. O script 
apresentado a seguir, O album fotos. php, faz exatamente isso, utilizando uma tabela 
HTML. Nele, você pode definir as imagens que farão parte do álbum, assim como 
o número de imagens a ser exibidas por linha da tabela. 


album fotos.php 


<?php 

$fotos = array( 
"gremio. jpg”, 
"guias. jpg”, 
"cooler. jpg", 
“guias. jpg”, 
“cooler. jpg”, 
"gremio. jpg” 
Ni 

$fotos_por_linha = 3; 

?> 

<html> 

<head> 

«title>Meu álbum de fotos</title> 

</head> 

<body> 

<hz align="center">Meu álbum de fotos</h2> 
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«div align="center"> 

<center> 

«table border="0" celIspacing="5" width="90%"> 
<?php 
// calcula o número de linhas da tabela 
inum fotos = sizeof(Sfotos); 
Gnum linhas = intval (Snum fotos/Sfotos por linha): 
if ($num fotos % $fotos por linha != 0) 

gnum linhas++; 


!/ imprime as tinhas e colunas 


Sindice = O; 
for ($i = 0; $i < $num linhas; $i) 
{ 
echo "<tr>"; 
for ($j = O; $} < $fotos por linha; $j++) 
{ 
if ($indice < $num fotos) 
{ 
Soriginal = $fotos[$indice]: 
!f monta O nome do arquivo miniatura 
$mini = explode('.", Soriginal); 
Smini = $mini{[0]."_mini. jpg"; 
echo "<td><a href=Soriginal><img sre=$mini border=0></a></td>"; 
Sindicem; 
} 
else 
echo "<td></td>"; . 
} 
echo "</tr>"; 
} 
7> 
</table> 
</center> 
</div> 
</body> 
</html> 


No array $fotos, definimos os nomes das imagens que serão exibidas no álbum. 
Esse array pode ter quantos elementos você desejar. A variável $fotos_por_linha in- 
dica quantas imagens devem ser exibidas em cada linha da tabela, ou seja, define 
o número de colunas dessa tabela. Veja na figura 7.20 o resultado obtido ao acessar 
a página album fotos.php no navegador. 


O número de fotos foi obtido com a função sizeof, que retorna o número de 
elementos de um array. Para calcular o número de linhas da tabela, dividimos o 
número de fotos pela quantidade de fotos por linha. Se a divisão não for exata (resto 
diferente de zero), somamos 1 ao número de linhas, pois será necessária uma linha 
a mais para exibir as últimas fotos (correspondentes ao resto da divisão): 
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Figura 7.20 - Álbum de fotos. 


fnum linhas = intval (num fotos / fotos por Tinha); 
if (fnum fotos % $fotos por Vinha != 0) 
$num Tinhas++; 


Logo após, começam a ser exibidas as imagens. A variável $indice é iniciada com 
zero e incrementada a cada acesso ao array $fotos. Note que existem dois coman- 
dos de repetição for. O primeiro tem como função criar as linhas da tabela HTML 
(escrevendo a tag <tr>), enquanto o segundo cria as células (escrevendo a tag <td>) e 
inclui dentro delas as miniaturas, com links para a imagem original: 


echo "<td><a href=Soriginal><img src=Smini border=0></a></td>": 


A variável $original contém o nome do arquivo no array Sfotos. Na variável mini, 
montamos o nome do arquivo miniatura, acrescentando mini ao nome original. 
Lembre-se de que esse arquivo da miniatura deve estar no mesmo diretório do 
arquivo original. 


Gráficos em formato de pizza 


A partir de agora, você irá aprender a gerar gráficos com o PHP, iguais àqueles ge- 
rados pelo Excel. O primeiro modelo que veremos é o gráfico em formato de pizza, 
que é utilizado para representar a participação de cada um dos valores dentro de 
uma série de dados. Para isso, calcula-se o percentual de cada um desses valores em 
relação ao valor total, ou seja, a soma de todos eles. 
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Por exemplo, imagine uma pesquisa feita com um determinado número de 
pessoas no Rio Grande do Sul, onde a pergunta era: “Por qual time você torce?” 
Após colher diversas respostas, poderíamos colocar os dados no Excel e chamar o 
assistente de geração de gráficos, que geraria um gráfico semelhante ao mostrado 
na figura 7.21, 


diz ead possas 


É cresio |. 

E tuventudo: f 
H Inter: É 
Ü Caxias 


Figura 7.21 — Gráfico de pizza gerado no Excel. 


Pode parecer complicado para você se imaginar criando um programa PHP 
para gerar um gráfico semelhante a esse, mas na realidade não é tão difícil assim, 
pelo menos para quem entende um pouco de matemática. O segredo consiste em 
fazer os cálculos corretos para posicionar os elementos (círculo, linhas, retângulos, 
textos) nos locais adequados. Veremos detalhadamente, passo a passo, como criar 
um gráfico em formato de pizza utilizando as funções apresentadas no decorrer 
deste capítulo. 


Primeiramente, vamos definir um arquivo separado com algumas variáveis de 
configuração relativas às dimensões da imagem, do círculo (que representará a pizza) 
e da legenda. Esse arquivo será nomeado como config grafico. inc e, posteriormente, 
chamado pelo programa principal: 
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config. grafico.inc 


<?php 


4! configurações do gráfico 


Slargura = 600; 
Saltura = 400; 


!f configurações do circulo 


fcentrox = 200; 
fcentroy = 200; 
$diametro = 280; 
Sangulo = 0; 


!f configurações da legenda 


texibir legenda = "sim"; 
Sfonte = 3; 

Slargura fonte = 8; 
altura fonte = 10; 


fespaco entre linhas = 10; 


fmargem vertical = 5; 


/! canto superior direito da legenda 


fix = 540; 
Sly = 30; 
7> 


A seguir, uma rápida descrição de cada uma dessas variáveis de configuração: 


Variável 
Slargura e faltura 


fcentrox e fcentroy 


$diametro 
fangulo 


Sexibir legenda 


Sfonte 


Descrição 


Representam a largura e altura, em pixels, da imagem na 
qual o gráfico será gerado. 

Representam as coordenadas x e y do centro do círculo 
(pizza). 

Diâmetro do círculo em pixels. 

Ângulo a partir do qual as opções (as fatias da pizza) come- 
carão aser desenhadas. Imagine queo valor zero corresponde 
ao número 3 em um relógio de ponteiros. 

Indica se a legenda deve ser exibida. Coloque o valor dessa 
variável com o valor “nao” caso você não queira exibir a 
legenda. 

Identificador da fonte que será usada para escrever O texto 
da legenda. Nesse exemplo, utilizou-se a fonte-padrão de 
tamanho 3. 


Slargura fonte e faltura fonte 


$espaco entre linhas 


Largura e altura, em pixels, da fonte escolhida na variável 
Sfonte. Se você alterar o tipo de fonte, possivelmente terá que 
ajustar esses valores. 


Define o espaçamento, em pixels, que deverá existir entre o 
texto de cada opção na legenda. 
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Variável Descrição (cont) 


margem vertical Define o espaçamento, em pixels, que deverá existir entre o 
texto e as bordas superior e inferior da caixa (retângulo) que 
contorna a legenda. 


$Ix e Sly Definem o ponto da imagem onde a legenda deve ser de- 
senhada. Representam as coordenadas do canto superior 
direito da legenda. 


Agora vamos ver como funciona o programa principal, responsável pela gera- 
ção do gráfico. Suponha que em nossa pesquisa foram entrevistadas 610 pessoas, 
que responderam à pergunta “para qual time você torce?” e o resultado final foi o 
seguinte: 


Ocorrências 
GRÊMIO 
JUVENTUDE 


Nesse primeiro exemplo, vamos definir os dados de nossa suposta pesquisa em 
dois arrays, chamados $dados e $valores. Posteriormente será mostrado como alterar 
o programa caso você deseje que o gráfico seja gerado com base em informações 
extraídas de seu banco de dados. 


Acompanhe, então, o programa grafico.php apresentado a seguir. À primeira vista, 
pode lhe parecer um pouco complexo, mas leia com calma as explicações apresenta- 
das logo após o código e certamente você entenderá como o programa foi criado. 


grafico.php 


<?php 

header ("Content-type: image/png"); 

!! inclui o arquivo com as configurações 

include "config grafico.inc"; 

f/ cria imagem e define as cores 

fimagem = ImageCreate($ largura, Saltura); 

$fundo = InageColorAllocate(Simagem, 236, 226, 226); 
Spreto = ImageColorANocate(Simagem, 0, 0, 0); 

$azul = ImageÇolorAl locate($imagem, 0, O, 255); 
Sverde = ImageColorATiocate(Simagem, O, 255, 0); 
$vermelho = ImageCotorAllocate(Simagem, 255, O, 0); 
Zamarelo = InageColorATIlocate(Simagem, 255, 255, 0); 
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!! definição dos dados 
$dados = array ("Gremio", "Juventude", "Inter", "Caxias"): 
$valores = array (280, 140, 120, 70); 
fcores = array (Sazul, $verde, $vermelho, Samarelo); 
¿/ cálculo do total 
$total = 0; 
$num linhas = sizeof(Sdados); 
for ($i = 0: $i < $num linhas; $i++) 
$total += $valores[$i]; 


/! desenha o gráfico 
ImageEtlipse (fimagem, $centrox, fcentroy, Sdiametro, $diametro, Spreto); 
Imagestring(Simagem, 3, 3, 3, "Total: ftotal pessoas”, Spreto); 


fraio = Sdiametro / 2; 
for ($i = 0; $i < Inum linhas; $i++} 


{ 
Spercentual = (fvalores[$i] / Stotal) * 100; 
Spercentual = number format(jpercentual, 2); 
Spercentual .= "%"; 
Sval = 360 * ($valores[Bi] / Stotal); 
Sangulo += $val; 
Sangulo meio = fangulo - ($val / Bi. 
$x final = $centrox + $raio * cos(deg2rad(Sangulo)); 
4y final = $centroy + (- raio * sin(deg2rad(fangulo))); 
$x meio = Scentrox + (Sraio / 2 * cos(deg2rad(Sangulo meio))); 
$y meio = Scentroy + (- $raio / 2 * sintdegirad(fangulo meio))); 
ix texto = $centrox + (Sraio * cos(deg2rad(Sangulo meio))) * 1.2; 
iy texto = Scentroy + C- $raio * sin(deg2rad(Sangulo meio))) * 1.2; 
ImageLine(Simagem, $centrox, $centroy, $x final, $y final, fpreto); 
ImageFillToBorder(Simagem, 9x meio, $y meio, preto, Scores[$1]); 
ImageString(Simagem, 2, $x texto, $y texto, Spercentual, Spreto); 
} 
ff — CRIAÇÃO DA LEGENDA ———— 
if (Sexibir legenda == "sim" 
{ 


ff acha a maior string 
fmaior tamanho = 0; 
for ($i = 0; $i < $num linhas; $i++) 
if Cstrlen(fdados[$1]) > maior tamanho) 
fmaior tamanho = strlen(Sdados[$i]): 


4! calcula os pontos de início e fim do quadrado 
fx inicio legenda = $łx - $largura fonte * (maior tamanho+4); 
fyinicio legenda = $ly; 


fx Fim legenda = $1x; 
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$y fim legenda = $1y + num Tinhas * (Saltura fonte + Sespaco entre linhas) 
+ 2*imargem vertical; 
ImageRectangle($imagem, x inicio legenda, $y inicio legenda, x fim legenda, 
$y fim legenda, Spreto); 


/f começa a desenhar os dados 
for ($i = 0; $i < $num linhas; $i++) 


{ 
$x pos = $x_inicio_legenda + $largura_fonte*3; 
$y-pos = $y_inicio_legenda + $i * ($altura_fonte + $espaco entre linhas) 
+ fmargem vertical; 
ImageString(fimagem, Sfonte, $x pos, fy. pos, Sdados[$i], preto); 
TmageFiliedRectangle (Simagem, $x pos-2*5largura fonte, &y pos, 
$x pos-$largura fonte, $y pos+faltura fonte, fcorestSiD): 
InageRectangle (Fimagem, $x.pos-2 * Slargura fonte, fy pos, $x pos - tlargura fonte, 
ty. pos + $altura fonte, Spreto); 
F 
} 
ImagePng(Fimagen); 
ImageDestroy(Simagem); 
?> 


Antes das explicações sobre os principais trechos desse programa, observe na 
figura 7.22 o resultado obtido ao executá-lo no navegador. Temos agora um progra- 
ma que gera gráficos em formato de pizza dentro de uma página web, sem precisar 
transportar os dados para um software externo, como o Excel. Um programa desse 
tipo é de grande utilidade para qualquer tipo de website que necessitar, a qualquer 
momento, de uma representação gráfica de um determinado conjunto de dados. 


fem 


Figura 7.22 — Gráfico de pizza gerado pelo programa grafico.php. 
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Iniciando a análise dos principais trechos do programa, primeiramente indicamos 
ao navegador com o comando header o tipo de imagem que será retornada. Nesse 
caso, trata-se de uma imagem no formato PNG. Logo após, inclui-se uma chamada 
ao arquivo de configuração config grafico. inc definido anteriormente. 


include 'config grafico.inc'; 


Em seguida, é feita a criação da imagem e alocação das cores, assim como ocor- 
reu nos outros exemplos que vimos neste capítulo. Posteriormente, são definidos 
os dados a partir dos quais o gráfico será gerado, ou seja, estamos definido as fatias 
da pizza! 

$dados = array ("Gremio", "Juventude", "Inter", “Caxias"); 


valores = array (280, 140, 120, 70); 
cores = array (Sazul, fverde, fvermelho, Samarelo); 


Os nomes das opções foram armazenados no array $dados, enquanto seus valores 
ficaram nas posições correspondentes no array valores. O array $cores indica com 
que cor deve ser exibida cada uma das opções no gráfico. Como foi citado no iní- 
cio desse tópico, mais adiante veremos como obter esses dados de forma dinâmica 
usando um banco de dados, em vez de valores fixos para cada array. 


O próximo passo consiste em calcular a soma de todos os valores da pesquisa, 
visto que é sobre esta que iremos calcular o porcentual de cada item. A função 
sizeof retorna o número de elementos de um array. Criamos, então, um laço com o 
comando for para percorrer o array de valores e acumulá-los na variável $total: 


Gnum linhas = sizeof(Sdados); 
for ($i = 0; $i < $num linhas; $i++) 
Stotal += $valores[Si]; 

A partir daí, iniciamos a criação do gráfico desenhando o círculo (pizza) com 
as medidas que estabelecemos no arquivo de configuração (config grafico. inc) e tam- 
bém um texto no canto superior esquerdo da imagem indicando o múmero total 
de pessoas entrevistadas: 


ImageEllipse (Simagem, Scentrox, Scentroy, $diametro, Sdiametro, fpreto); 
ImageString(Simagem, 3, 3, 3, “Total: Stotal pessoas”, fpreto); 


Precisaremos da medida do raio do círculo para realizar alguns cálculos. O raio 
de um círculo é igual à metade de seu diâmetro: 


$raio = $diametro / 2; 


Logo após, começamos a desenhar as fatias da pizza. Cria-se um laço com o 
comando for, em que a cada iteração são executadas as seguintes ações: 
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O porcentual do item é calculado em relação ao valor total. Esse valor é forma- 
tado com duas casas decimais e o símbolo % é concatenado ao resultado. 


Spercentual = (Svalores[$i] / $total) * 100; 
fpercentual = number format(fpercentual, 2); 
fpercentual .= "%"; 


a 


O tamanho da fatia é definido por meio do cálculo da variação do ângulo. 
Essa variação é um percentual da variação total (3609). Obtemos também o 
ângulo intermediário da fatia, pois iremos utilizá-lo logo a seguir: 


$val = 360 * (Svalores[$i] / Stotal); 
Sangulo += $val; 
Sangulo meio = fangulo - (Sval / 2); 


São calculadas as coordenadas x e y de três pontos. O primeiro é o ponto 
final da linha a ser traçada para delimitar a região da opção em questão. Essa 
linha partirá do centro do círculo. Descobrir o ponto exato da circunferência 
onde a linha deve terminar envolve um pouco de trigonometria. Devem ser 
usadas as funções trigonométricas seno (sin) e co-seno (cos) do ângulo em 
questão. Temos o valor do ângulo em graus, mas devemos convertê-lo para 
radianos antes de passá-lo como parâmetro. Essa conversão é feita pela função 
degirad: 


$x final = $centrox + $raio * cos(deg2rad(Sangulo)); 
$y final = $centroy + (- $raio * sin(deg?rad($angulo))); 


O segundo ponto a ser calculado é um ponto intermediário, localizado no 
centro da fatia. Esse ponto será utilizado apenas como referência para colorir 
essa região posteriormente: 


fxmeio = fcentrox + (raio / 2 * cos (deg2rad(fangulo meio))): 
Sy meio = Scentroy + (- $raio / 2 * sin(degarad(Sangulo meio))); 


O terceiro ponto a ser calculado define onde será escrito o texto correspon- 
dente à opção em questão. Para centralizá-lo em relação à região da fatia, 
utilizamos o ângulo intermediário calculado anteriormente. A multiplicação 
pelo fator 1.2 serve para que o texto seja escrito um pouco afastado da cir- 
cunferência. 


Se você aumentar esse valor, o texto ficará ainda mais afastado: 


ix texto = fcentrox + (raio * cos(deg2rad(Sangulo meio))) * 1.2; 
$y_texto = fcentroy + (- $raio * sinídeg?rad(Sangulo meio))) * 1.2: 
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4. A linha é traçada e a fatia é preenchida com a cor escolhida para a opção. 


O preenchimento é feito com a função ImageFi11ToBorder, que aplica uma cor 
especificada dentro de uma determinada região. Essa função utiliza como 
referência um ponto, preenchendo toda a região a qual esse ponto pertence. 
O quarto parâmetro indica com que cor deve ficar a borda dessa região. Nesse 
caso, utilizou-se a cor preta para a borda: 


ImageLine(Simagem, fcentrox, Scentroy, $x final, $y final, preto); 
TnageFilNToBorder CSimagem, $x meio, $y meio, preto, $cores[$1]); 


O texto é escrito na posição adequada. Esse texto é O percentual que indica 
a participação da opção em questão em relação ao total: 


ImageString(Simagem, 2, fx texto, &y texto, percentual, fpreto); 


Nesse ponto, já temos o círculo (pizza) e suas divisões (fatias) todas definidas. 


Falta apenas criar a legenda, que vai indicar à pessoa que visualizar o gráfico qual 


opção corresponde a cada uma das cores. A exibição da legenda é opcional. Se você 


não quiser exibi-la, coloque o valor “nao” na variável exibir. legenda no arquivo de 


configuração config. grafico. inc. 


Para inserir a legenda no gráfico, primeiramente desenhamos o retângulo que 
ficará em torno dela. Para calcular o tamanho desse retângulo, precisamos das 
seguintes informações: 


número de opções existentes; 

tamanho do maior texto entre as opções; 
largura e altura da fonte; 

espaço entre as linhas; 


margem vertical. 


O número de opções já foi retornado no início do programa, na variável $num linhas. 
As configurações da fonte, espaçamento e margens, você também já definiu nas vari- 
áveis do arquivo de configuração. Falta apenas obter o tamanho do maior texto entre 
as opções, o que é feito analisando-se o tamanho (strlen) de cada uma delas: 


Smaior tamanho = 0; 
for ($i = 0; $i < num linhas; $i++) 


if (strlenCidados[$1]) > maior tamanho) 
maior tamanho = strlenCSdados[$i]); 
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Agora que temos as informações necessárias, calculamos os pontos de início 
e fim do retângulo da legenda. Lembre-se de que definimos no arquivo de confi- 
guração as variáveis $1x e $1y, que representam as coordenadas do canto superior 
direito da legenda: 


ix início. lagenda = $1x - $largura fonte * (maior tamanho + 4); 

$y início legenda = $1y; 

fx fim legenda = $1x; 

3y fim legenda = 51y + fnum linhas * (Saltura fonte + Sespaco entre linhas) 
+ 2 * margem vertical; 


No cálculo do ponto x do início do retângulo, foi somado o valor 4 ao maior 
tamanho, para deixar um espaço de quatro posições para desenhar um quadrado 
preenchido com a cor da opção. No cálculo do ponto y do fim do retângulo, para 
cada opção consideraram-se a altura da fonte e o espaço em relação à linha se- 
guinte. Somou-se também a margem vertical multiplicada por 2, representando as 
margens superior e inferior. Com os pontos delimitadores do retângulo definidos, 
basta desenhá-lo: 


ImageRectangle(Simagem, $x inicio legenda, $y inicio legenda, 3x Fim Tegenda, 
$y fim legenda, fpreto); 


Para finalizar, criou-se um laço com o comando for para desenhar todas as opções 
existentes no array de dados. Dentro desse laço, para cada opção são calculados 
os pontos x e y a partir dos quais o texto deve ser desenhado. Para a coordenada 
x, basta tomar como referência o x de início da legenda ($x. inicio legenda), não se 
esquecendo de deixar um espaço para o quadrado colorido que será desenhado 
antes do texto, Quanto à coordenada y tomamos como referência o y de início da 
legenda ($y inicio legenda) com a variável de controle $i, que será usado como fator 
de multiplicação para aumentar o valor de y fazendo que um texto seja escrito 
abaixo do outro: 


$x pos = $x inicio legenda + $largura fonte * 3; 
fy.pos = Sy inicio Jegenda + $i * (faltura fonte + Sespaco entre linhas) + margem vertical; 


Agora basta escrever o texto nas posições calculadas e desenhar o quadrado a 
seu lado. Utilizamos a função ImageFiNedrectangle para desenhar o quadrado pre- 
enchido com a cor definida e, logo após, o ImageRectangle para desenhar uma borda 
preta para esse quadrado: 


ImageString(timagem, $fonte, $x pos, $y pos, Sdados[$i], Spreto); 

ImageFiVedRectangle (Simagem, fx pos - 2 * Slargura fonte, $y pos, $x pos - Slargura fonte, 
$y pos + $altura fonte, fcores[$1]); 

ImageRectangle ($imagem, $x pos - 2 * $largura fonte, $y pos, 3x pos - $largura fonte, 
$y. pos + altura fonte, $preto); 
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Pronto! O gráfico já está criado. Basta enviar a imagem resultante ao navegador 
e liberar a memória utilizada para ela: 


ImagePng(Simagem); 
ImageDestroy(Simagem) ; 


Vamos ver agora como alterar esse programa para gerar o gráfico a partir de 
consultas feitas a um banco de dados MySQL, em vez de utilizar valores fixos para o 
array, como fizemos nesse exemplo. Imagine que seu site possui um banco de dados 
com uma tabela chamada usuario, utilizada para guardar as informações das pessoas 
que se cadastram. Vamos supor que essa tabela foi criada da seguinte forma: 


create table usuario 

( 
username varchar(10) NOT NULL, 
nome varchar (80) NOT NULL, 
email varchar(80) NOT NULL, 
sexo char NOT NULL, 
data nasc date NOT NULL, 
cidade varchar(40) NOT NULL, 
estado char(2) NOT NULL, 
senha varchar(10) NOT NULL 

); 


Se você precisar, por exemplo, gerar um gráfico para ver como estão distribuídos 
seus usuários geograficamente, podemos agrupá-los por estado e utilizar o resul- 
tado desse agrupamento em nosso programa grafico.php. Vejamos como isso pode 
ser feito. Atualmente, os dados estão definidos no programa de forma fixa, como 
mostrado a seguir: 


$dados = array ("Gremio", "Juventude", "Inter", "Caxias"); 
$valores = array (280, 140, 120, 70); 


Para que os arrays $dados e $valores sejam montados de forma dinâmica a partir 
do banco de dados, substitua as duas linhas anteriores pelo seguinte código: 


Sservidor = "localhost"; 
Susuario = "juliano" 
$senha = "12345"; 
fbanco = "bdteste"; 
icon = mysql connect(£servidor, fusuario, fsenha); 
mysql select db Cfbanco); 
$res = mysql query("select estado, count (*) from usuario group by estado"); 
$num linhas = mysql numrows(Sres); 
for (fi = 0: $i < num linhas; $i++) 
{ 
$dados[] = mysql_result{$res,$i,0); 
fvalores[] = mysql_result{$res, $1,1); 
É) 


mysql. close(fcon); 
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Esse trecho de código faz uma conexão e uma consulta ao banco de dados no 
qual foi criada a tabela usuario. Modifique as quatro primeiras variáveis ($servidor, 
$usuario, Ssenha, $banco) de acordo com suas configurações. 


As linhas resultantes dessa consulta são atribuídas aos arrays $dados e fvalores 
através de um laço for. Os dados correspondem ao nome do estado do usuário, 
enquanto os valores, ao número de ocorrências de cada um deles na tabela. Veja na 
figura 7.23 o resultado obtido ao abrir a página no navegador. 


Um detalhe muito importante: no exemplo do programa grafico.php, O array 
$cores possui apenas quatro elementos, já que só havia quatro opções. Porém, se 
sua consulta for retornar mais de quatro opções, basta acrescentar mais cores a 
esse array. Você pode adicionar quantas cores quiser, mesmo que não vá utilizá-las 
no momento. Por exemplo, você pode definir 30 cores para o array $cores, então à 
medida que forem surgindo novas opções em seu banco de dados, já haverá uma 
cor definida para elas no array, sem que você precise ficar alterando o programa a 
todo momento. 


Figura 7.23 — Gráfico com informações extraídas de um banco de dados. 


Com os exemplos do livro no site da editora, você encontrará um arquivo adicio- 
nal chamado grafico. bd. php, que é praticamente o mesmo programa que o grafico.php, O 
qual contém essa alteração que foi recém-sugerida para obtenção das informações a 
partir de um banco de dados. Se você pretende operar com banco de dados, utilize 
esse arquivo como referência. 
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Vejamos rapidamente um outro exemplo. Nessa mesma tabela, poderia ser fei- 
ta uma pesquisa semelhante baseada no sexo dos usuários. Assim, seria possível 
gerar um gráfico mostrando o percentual de homens e mulheres cadastrados. Essa 


3 


alteracão é bastante simples, bastando apenas trocar a palavra “estado” por “sexo” 
p 


na linha que executa a consulta. 


$res = mysql_query{"select sexo,count{*) from usuario group by sexo"); 


Fazendo essa modificação e abrindo a página no navegador, você verá uma tela 
semelhante à mostrada na figura 7.24. 


Endereço [EM hteo 


Total: 4% pessoas 


Figura 7.24 — Gráfico criado com base no banco de dados. 


Gráficos de colunas 


O gráfico de colunas é utilizado para visualizar as alterações registradas em um 
conjunto de dados ao longo de um período de tempo ou para ilustrar comparações 
entre alguns itens. Os itens são especificados no sentido horizontal e os valores, no 
sentido vertical. 


Vejamos um exemplo. Suponha que durante três anos consecutivos se efetuou 
uma pesquisa no Rio Grande do Sul para saber o time de futebol pelo qual as 
pessoas torcem e o resultado obtido foi o seguinte: 
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Time `} 2000F | 2002 


2003 


GRÊMIO 510.000 525.000 850.000 
JUVENTUDE [170000 275000 |270000 


INTER [eooo 300.000 470.000 
CAXIAS 35.000 75.000 85.000 


Se você colocasse esses dados no Excel e chamasse o assistente de geração de 
gráficos, seria gerado o gráfico mostrado na figura 725. 


Veremos detalhadamente como criar um gráfico de colunas com o PHP utili- 
zando as funções apresentadas no decorrer deste capítulo. Assim como foi feito no 
gráfico em formato de pizza, primeiramente vamos definir um arquivo separado 
com algumas variáveis de configuração relativas ao gráfico e à legenda. Esse arqui- 
vo será nomeado como config grafico colunas. inc e, posteriormente, chamado pelo 
programa principal. 


700000 


annnDo 


500000 


420000 


Boo 


200000 


100000 


Figura 7.25 — Gráfico de colunas gerado no Excel. 


config grafico colunas.inc 


<?php 

/! configurações do gráfico 

$titulo = "Torcedores do Rio Grande do Sul"; 
Slargura = 700; 

faltura = 400; 

Slargura eixo x = 450; 

Slargura eixo y = 300; 

Sinicio grafico x = 70: 

$inicio grafica y = 360; 
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4! configurações da legenda 
fexibir legenda = "sim"; 


$fonte = 3; 
$largura_fonte = 8; /! largura em pixels (2=6,3=8,4=10) 
$altura fonte = 10; {f altura em pixels (2=8,3=10,4=12) 


Sespaco entre Yinhas = 10; 
Smargen vertical = 5; 
/f canto superior direito da legenda 


$ix = 660; 
Sly = 30; 
?> 


O título do gráfico, configurado na variável Stítulo, será exibido no canto supe- 
rior esquerdo da imagem. As variáveis $largura e faltura definem as dimensões da 
imagem na qual o gráfico será criado. O tamanho dos eixos, em pixels, é definido 
pelas variáveis $largura eixo. x e $largura eixo. y. Os eixos serão desenhados a partir do 
ponto inicial do gráfico, definido pelas variáveis $inicio grafico x e $inicio. grafico y. As 
demais variáveis, relativas à configuração da legenda, são idênticas às do exemplo 
anterior Consulte a descrição de cada uma delas no tópico anterior, sobre gráfico 
em formato de pizza. 


Agora vamos ver como funciona o programa principal, responsável pela geração 
do gráfico de colunas. Nesse exemplo, vamos definir os dados de nossa suposta 
pesquisa em três arrays, chamados $texto linha (armazena o nome dos times), $tex- 
to coluna (armazena os anos) e $valores (armazena os valores para cada linha/coluna). 
É importante lembrar que esse programa não suporta valores negativos, ou seja, os 
elementos do array valores devem ser sempre maiores que ou iguais a zero. Mais 
adiante, veremos como alterar o programa pata que este obtenha dinamicamente 
essas informações, a partir de uma consulta a um banco de dados. 


Acompanhe, então, o programa grafico colunas. php apresentado a seguir e, logo 
após, as explicações sobre os principais trechos de código. 


grafico colunas.php 


<?php 

header("Content-type: image/png”); 

ff inclui o arquivo com as configurações 
include "config grafico colunas.inc"; 


ti cria imagem e define as cores 

$imagem = ImageCreate($largura, Saltura); 

$fundo = ImageColorAllocate{$imagem, 236, 226, 226); 
$preto = ImageColorAltocate($imagem, O, O, 0); 

Sazul = ImageColoraTIocate(Simager, D, O, 255); 
fverde = ImageColorAlTocate(Simagem, O, 255, 0); 
$vermelho = ImageColorATlocate(fimagem, 255, 0, 0); 
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famarelo = ImageColorANocate(Simagem, 255, 255, 0); 


ff! definição dos dados 
/! Vinhas representam os valores, colunas representam os intervalos 
ftexto linha = array ("Gremio", "Juventude", "Inter", “Caxias"); 
$cores linha = array ($azul, fverde, Svermelho, famarelo); 
ftexto coluna = array ('2001", "2002", "2003"3: 
valores = array ( 
510000, 525000, 650000, 
170600, 275000, 270000, 
460000, 300000, 170000, 
35000, 75000, 85000 
J; 
$numero_linhas = sizeof($texto_linha}; 
$numero_colunas = sizeof(Stexto coluna); 
$numero_valores = sizeof(Svalores); 


// obtém o valor máximo de y 
$y maximo = 0; 
for ($i = 0; $i < numero valores; $i++) 
if CSvalores[$i] > $y maximo) 
Sy maximo = $valores[$i]; 


/! calcula o intervalo de variação entre os pontos de y 
$fator = pow (10, strlenCintval(3y maximo)) - 1); 
if C5y maximo < 1) 
Svariacao = 0,1; 
elseif ($y maximo < 10) 
Svariaçao = 1; 
elseif ($y maximo < 2 * $fator) 
Svariacao = $fator / 5; 
elseif (fymaxino < 5 * $fator) 
ivariacao = fator / 2; 
elseif ($y maximo < 10 * $fator) 
tvariacao = Sfator; 
!! calcula o número de pontos no eixo y 
$num pontos eixo y = 0; 
fvalor = 0; 
while ($y maximo >= &valor) 
{ 
$valor += $variacao; 
$num_pontos_eixo_y++; 
k 
Svalor topo = Svalor; 
fdist entre pontos = $Slargura eixo y / fnum pontos eixo y; 


ff titulo 
ImageString(Simagem, 3, 3, 3, $titulo, preto); 


ff eixos x ey 
ImagelLine(Simagem, Sinicio grafico x, Sinicio grafico y, Sinicio grafico x+$largura eixo x, 
$inicio grafico y, Spreto); 
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InageLine(Simagem, Sinicio grafico x, Sinicio grafico. y, Sinicio grafico x, 
$inicio grafico y-Slargura eixo. y, Spreto); 


/! pontos no eixo y 
Sposy = Sinicio.graficoy; 
valor = 0; 
for ($i = 0; ți <= fnum pontos eixo y; $i++) 
{ 
$posx = $inicio_graficox -(strlen(fvalor)+2) * 6; // 6 da largura fonte+? espaços 
ImageString(Simagem, 2, Sposx, $posy-7, $valor, $preto); 
ImageLine(Simagem, finicio grafico. x-6, fposy, Sinicia grafico x+ilargura eixo x, 
Sposy, Spreto); 
$valor += Svariacao; 
$posy -= $dist entre pontos; 
É 
/! colunas no eixo x 
$num barras = $numero linhas * $numero colunas; 
largura barra = floor(Slargura eixo x / Cinum barras+$numero colunas + 1)); 
$posx = Sinicio. grafico x + $largura barra; 


for ($i = 0; $i < fnumero colunas; $i++} 


í 
/! label da coluna 
$pos. label x = $posx + (Slargura barra*fnumero linhas / 2) - 
(strlenCitexto coluna[$11)*6/2); 
pos Jabel.y = $inicio grafico.y + 10; 
TmageString(Simagem, 2, $pos label. x, $pos label y, $texto coluna[$i], preto); 
// imprime as barras 
for ($j = $i; $j < fnumero valores; $j += $numero colunas) 
1 
altura barra = $valores[5j] / fvalor topo * Slargura eixo y; 
$indice cor = intval ($j / numero colunas); 
ImageFiVledRectangle(Simagem, $posx, Sinicio grafico y-Saltura barra, 
$posx+S largura barra, $inicio grafico y, Scores hinha[S$indi ce cor]); 
InageRectangle(Sinagem, $posx, Sinicio grafico y-Saltura barra, 
$posx + $largura barra, Sinicio grafico y, Spreto); 
$posx += $targura barra; 
} 
$posx += flargura barra; 
F 


ii FRERANERIAA CRIAÇÃO DA LEGENDA ERRAR RAE 
if (Sexibir legenda == "sim") 
{ 
/! acha a maior string 
$maior tamanho = O; 
for ($i = 0; $i < fnumero Vinhas; $i++) 
if (strlen(Stexto Tinha[$i]) > $maior tamanho) 
maior. tamanho = strlen(Stexto Tinha[$i)); 


44 calcula os pontos de inicio e fim do quadrado 
Sx inicio legenda = $1x - Slargura fonte * (fmaior tamanho + 4); 
$ycinicio legenda = Sly; 
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$x fim legenda = 41x; 

ty fim legenda = $1y + $numero linhas * (Saltura fonte + Sespaco entre linhas) + 
2 * Smargem vertical; 

lnageRectangle(Simagem, $x inicio legenda, $y inicio legenda, fx fim legenda, 
$y Fim legenda, Spreto); 


/f! começa a desenhar os dados 
for ($i = 0; $i < $numero linhas; $i++) 


{ 
$x_pos = $x_inicio_legenda + $largura_fonte*3; 
$y_pos = $y inicio legenda + $i * ($altura fonte + $espaco_entre_linhas) + 
fmargem_vertical; 
ImageString($imagem, $fonte, fx pos, $y_pos, $texto_linha[$i], $preto): 
ImageFilledRectangle ($imaem, fx pos - 2 * Slargura fonte, $y_pos, 
$x_pos - $targura_fonte, $y_ pos + $altura_fonte, $cores_linha[$i]}; 
ImageRectangle ($imagem, $x_pos - 2 * $largura fonte, $y pos, 
$x pos-Slargura fonte, $y post+faltura fonte, $preto); 
: 
} 
ImagePng{$imagem) ; 
ImageDestroy(Simagen): 
?> 


Antes das explicações sobre os principais trechos desse programa, observe na 
figura 7.26 o resultado obtido ao executá-lo no navegador. 


Figura 7.26 — Gráfico de colunas gerado pelo programa grafico colunas. php. 
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Iniciando a análise dos principais trechos do programa, primeiramente indicamos 
ao navegador com o comando header o tipo de imagem que será retornada. Nesse 
caso, trata-se de uma imagem no formato PNG. Logo após é incluída uma chamada 
ao arquivo de configuração config. grafico. colunas inc definido anteriormente: 


include "config grafico colunas. inc”; 


Em seguida, efetuam-se a criação da imagem e alocação das cores, assim como 
ocorreu nos outros exemplos que vimos neste capítulo. Posteriormente, são definidos 
os dados com base nos quais o gráfico será gerado: 


$texto Tinha = array ("Gremio”, “Juventude”, “Inter”, "Caxias"; 
Scores linha = array (fazul, Sverde, Svermelho, Samarelo); 
Stexto coluna = array "2001", "2002", "2003"); 
Svalores = array ( 

510000, 525000, 650000, 

170000, 275000, 270000, 

460000, 300000, 170000, 

35000, 75000, 85000 

J: 


Os nomes das opções foram armazenados no array $texto_linha, Os anos, no array 
Stexto. coluna, € os valores para cada linha/coluna ficaram no array $valores. Imagine 
o array $valores como sendo uma tabela, onde cada três elementos consecutivos 
representam uma linha dessa tabela, visto que temos três colunas nesta. 


O array Scores indica com que cor deve ser exibida cada uma das opções no 
gráfico. Como foi citado no início desse tópico, mais adiante veremos como obter 
esses dados de forma dinâmica usando um banco de dados, em vez valores fixos 
para cada array. 


Em seguida, após obter o número de elementos dos arrays com a função sizeof, 
devemos percorrer o array $valores a fim de encontrar o maior valor existente, pois 
essa informação será importante para definir os pontos do eixo y e o intervalo 
numérico que deve existir entre cada um deles: 


Sy-maximo = 0; 
for ($i = 0; $i < numero valores; $i++) 
if (Svalores[$i] > $y maximo) 
$y maximo = fvalores[$il; 


O próximo passo talvez seja o mais difícil do programa. Consiste em definir o 
intervalo numérico de variação entre os pontos do eixo y, assim como o número 
de pontos que serão desenhados. Para esse cálculo, devemos tomar como base o 
valor máximo de y recém-calculado. Se você fizesse uma análise para ver como o 
Excel define essas informações, veria que o intervalo é definido como sendo uma 
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determinada parte de uma potência de 10. Chamaremos essa potência de fator e, 
para obtê-la, utilizaremos a função pow para retornar a potência de 10 que tem o 
mesmo número de dígitos do valor máximo de y: 


$fator = pow (10, strlen(intval ($y maximo))-1); 


A 


Quanto maior for o valor do y máximo, maior será a variação numérica entre 
os pontos do eixo y. Nossa definição da variação será semelhante à do Excel e fun- 
cionará da seguinte forma: 


1. Seo valor máximo for menor que 1, adotaremos 01 como variação. 
2. Se o valor máximo estiver entre 1 e 10, adotaremos 1 como variação. 


3. As próximas variações devem continuar aumentando conforme o valor do 
y máximo. No Excel, à medida que o valor máximo cresce, a variação vai 
aumentando seguindo a segiência: 2, 5, 10, 20, 50, 100, 200, 500, 1000, 2.000, 
5000 etc. Esses valores nada mais são do que uma parte do fator (ou o próprio 
fator) que recém-calculamos. 


A seguir será mostrado o trecho de código que implementa esse procedimento 
de definição da variação: 


if (Gy taximo < 1) 
Svariacao = 0.1; 

elseif ($y maximo < 10) 
fvariaçãao = 1; 

elseif ($y maximo < 2*$fator) 
fvariacao = $fator / 5; 

elseif ($y_maximo < 5*$fator) 
$variacao = $fator / 2; 

elseif ($y_maximo < 10*$ffator) 
$variacao = $fator; 


De posse do valor da variação, calculamos o número de pontos a ser desenha- 
dos no eixo y. Isso é feito por meio de um laço com o comando while, onde o valor 
da variação é acumulado na variável $valor, até que esta se torne maior do que o y 
máximo. À cada iteração desse laço, contabilizamos um ponto no eixo y: 


Svalor = 0; 
while ($y maximo >= $valor) 


{ 


$valor += $variacao; 
$num pontos eixo y++; 


} 


Ao final do laço, a variável $valor irá conter o valor do topo do gráfico, isto é, O 
ponto mais alto de y que será desenhado. Antes de desenhar os pontos do eixo y 
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no gráfico, é necessário calcular a distância (em pixels) entre eles. Para isso, basta 
dividir a largura do eixo pelo número de pontos que este deve ter: 


$Sdist entre pontos = Slargura eixo y / $num pontos eixo y; 


A seguir, o gráfico começa a ser desenhado. Primeiramente é desenhado, no canto 
superior esquerdo da imagem, o título que você definiu no arquivo de configura- 
ção. Logo após são desenhados os eixos, baseados nos pontos de início e fim e no 
tamanho dos eixos x e y, também definidos no arquivo de configuração: 


ImageString(timagem, 3, 3, 3, $titulo, fpreto); 

ImageLine(Simagem, finicio grafico x, $inicio grafico y, $inicio grafico x+Slargura eixo x, 
Sinicio grafico y, fpreto); 

ImageLine(Simagem, $inicio grafico x, Sinicio grafico y, Sinicio grafico x, 
Sinicio grafico y-Slargura eixo y, preto); 


O próximo passo é desenhar os pontos do eixo y. Para isso, utilizou-se como 
referência uma variável chamada $pos y, cujo valor inicial é o ponto onde começa 
o eixo y, e a variável fvalor, que inicia com zero e indica o valor a ser escrito para o 
ponto: 


4posy = Sinicio grafico y; 
valor = 0; 


Em seguida, cria-se um laço com o comando for e, para cada um dos pontos do 
eixo y são executados os seguintes passos: 


1. Calcula-se a posição do eixo x onde o valor deve ser escrito. Esse cálculo 
toma como referência o ponto x de início do gráfico, subtraindo desse ponto 
o tamanho do texto a ser escrito, em pixels. Esse tamanho é o produto do 
número de caracteres do texto pela largura da fonte com a qual será escrito. 
No exemplo, utilizou-se uma fonte-padrão de tamanho 2, que possui 6 pixels 
de largura: 


Sposx = $inicio grafico x - (strlen($valor)+2)*6; 


Foi somado o valor 2 ao número de caracteres apenas para deixar dois espaços 
em branco entre o texto e o eixo. 


2. O valor é escrito com a função ImageString e é traçada uma linha horizontal 
desse ponto até o fim do gráfico. Essa linha foi traçada apenas para fornecer 
uma melhor visualização do valor correspondente a uma coluna no eixo y: 


ImageString(Sinagem, 2, Sposx, $posy-7, fvalor, preto); 
ImageLine(Simagem, Sinicio grafico x-6, fposy, 
$inicio grafico x+flargura eixo x, $posy, fpreto); 
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3. O valor é incrementado com a variação que calculamos anteriormente e a 
posição de y é atualizada para o desenho do próximo ponto. Lembre-se de 
que quanto menor o valor de y mais acima estaremos desenhando: 


Svalor += $variacao; 
$posy -= fdist entre pontos; 


Terminado esse laço, todos os pontos do eixo y já terão sido desenhados, Resta- 
nos desenhar o nome das opções no eixo horizontal, assim como as colunas que 
representam cada uma delas, Note que nesse exemplo teremos três colunas, repre- 
sentando os anos de 2001, 2002 e 2003. Porém, em cada uma dessas colunas deverão 
ser desenhadas quatro barras verticais, uma para cada time (Grêmio, Juventude, Inter 
e Caxias). O número total de barras é o produto das linhas pelas colunas: 


$num barras = $numero linhas * $numero. colunas; 


Em nosso exemplo, temos 4 linhas e 3 colunas, portanto teremos 3 * 4 = 12 barras. 
Para encontrar a largura em pixels de cada barra, basta dividir a largura do eixo 
pelo número de barras, 


Vamos somar também ao número de barras um espaço adicional para separar 
cada coluna, além de mais um espaço no início do eixo x, para evitar que as barras 
fiquem grudadas no eixo. A função floor serve para arredondar o resultado: 


largura barra = Floor($largura eixo x / ($num barras+$numero colunas+1)): 


A variável $posx será usada como referência para desenhar as barras: 


Sposx = Sinicio grafico x + $largura barra; 


Para cada barra desenhada, a variável $posx será atualizada, somando-se a ela o 
valor da largura da barra. O próximo passo é definir um laço com o comando for 
para desenhar o nome das opções e, dentro dele, outro laço para desenhar as barras 
para cada uma dessas opções. 


Para definir a posição correta do texto, devemos calcular as coordenadas x e y que 
façam com que seja escrito no centro da coluna atual e um pouco abaixo do eixo. 
Vamos escrevê-lo 10 pixels abaixo do eixo, somando 10 ao valor da coordenada y do 
início do gráfico. Já para a coordenada x, vamos centralizar o texto considerando a 
posição central da coluna e o número de caracteres desse texto: 


pos label x = $posx + ($largura barra*$numero, Vinhas/2) - (strlen(Stexto coluna[$i])*6/2); 
$pos label y = $inicio grafico y + 10; 
ImageString(Yimagem, 2, $pos label x, $pos label y, Stexto coluna[$i], 3preto); 
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O próximo laço desenha as barras relativas a cada coluna, baseando-se no array 
de valores definido no início do programa. À variável de controle do laço é incre- 
mentada de acordo com o número de colunas. Isso é feito porque, para desenhar 
a primeira coluna, devemos obter os elementos $valores[0], $valores[3], $valores[6] € 
$valores[9]; a segunda coluna utiliza os elementos $valores[11, $valores[4], $valores[7] 
e fvalores [10], e assim por diante: 


for ($j = $i; $j < fnumero valores; $j += fnumero colunas) 
Dentro desse laço, são executados os seguintes passos: 


1. Calcula-se a altura da barra como sendo um percentual da medida do eixo y: 


faltura barra = $valores[4j] / Svalor topo * Slargura eixo y; 


2. Obtém-se a cor da barra (que definimos no array de cores) de acordo com o 
valor em questão: 


findice cor = intval {$j / numero colunas); 
3. Abarra é desenhada com seu contorno: 


InageFilledRectangla(fimagem, $posx, $inicio grafico y - Saltura barra, 
&posx + $largura barra, $inicio grafico y, Scores linhalfindice..cor]); 
ImageRectangle(Simagem, Sposx, Sinicio grafico y - Saltura barra, 
$posx + $largura barra, Sinicio.grafico y, Spreto); 


4. A posição de x é incrementada para o desenho da barra seguinte: 


$posx += largura barra; 


Por fim, mostra-se a legenda do gráfico, da mesma forma como se fez no exemplo 
anterior. As explicações sobre a geração da legenda podem ser consultadas no tópico 
anterior sobre a geração de gráficos em formato de pizza. 


Vamos ver agora como alterar esse programa para gerar o gráfico a partir de con- 
sultas feitas a um banco de dados MySQL, em vez de utilizar valores fixos para o array. 
Imagine que seu site possui um banco de dados com uma tabela chamada pesquisa, 
utilizada para armazenar as informações referentes à pesquisa de nosso exemplo. 


Vamos supor que essa tabela foi criada da seguinte forma: 


create table pesquisa 

{ 
time varchar (20) NOT NULL, 
ano char(4) NOT NULL, 
valor int NOT NULL, 
primary key(time,ano) 

J 
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Antes de alterar o programa PHP para acessar essa tabela, vamos inserir nela 
os dados relativos à pesquisa sobre o time de futebol. Veja que os campos time e ano 
compõem a chave primária da tabela. Não pode haver mais de um registro contendo 
o mesmo time e ano: 


insert into pesquisa values ('Grêmio”, '2001', 510000); 
insert into pesquisa values ('Grêmio', '2002", 525000); 
insert into pesquisa values ('Grêmio", '2003', 650000); 
insert into pesquisa values ('Juventude”, "2001", 170000); 
insert into pesquisa values (Juventude”, "2002", 275000); 
insert into pesquisa values ('Juventude", "2003", 270000); 
insert into pesquisa values ('Inter", "2001", 460000); 
insert into pesquisa values ('Inter', '2002', 300000); 
insert into pesquisa values ('Inter", '2003', 170000); 
insert into pesquisa values ('Caxias", '2001', 35000); 
insert into pesquisa values ('Caxias", '2002', 75000); 
insert into pesquisa values ('Caxias", '2003', 85000); 


Agora vamos alterar o programa PHP para que passe a operar com banco de 
dados. Atualmente, os dados estão definidos no programa grafico. colunas.php de 
forma fixa, nos arrays texto linha, $texto coluna € $valores. Para que esses arrays se- 
jam montados de forma dinâmica a partir do banco de dados, substitua as linhas 
que lhes atribuem os valores pelo seguinte código (obs.: mantenha apenas o array 
Scores. linha): 


Sservidor = "localhost"; 
Susuario = “juliano”; 
fsenha = "12345"; 

fbanco = "bdteste”; 


$con = mysql connect(fservidor, $usuario, $senha); 
mysql select db (Sbanco); 


/! define as linhas 
$res = mysql query("select distinct(time) from pesquisa"); 
fnumero times = mysql numrows(Sres); 
for (H = 0; $i < fnumero times; $i++) 
$texto Jinhal] = mysql result(tres,$i,0); 


// define as colunas 
$res = mysql query("select distinct(ano) from pesquisa"); 
$numero anos = mysql numrows(Sres); 
for ($i = 0; $i < numero anos; $i++) 
&texto colunal[] = mysql result(Sres,$i,0); 
!! define os valores 
for ($i = 0; $i < numero times; $i++) 
{ 
for ($j = 0; $j < $numero_anos; $j++) 


{ 
time = $texto_linha[$i]; 
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Sano = Stexto coluna[$j]; 

$res = mysql query("select valor from pesquisa where time='$time' and ano=Sano"); 

Sachou = mysql numrows(fres): 

if (Sachou) 
$valores[] 

else 
$valores[] 


mysql result(fres,0,0); 


0; 
} 
l 


mysql_close{$con}; 


Modifique as quatro primeiras variáveis ($servidor, $usuario, $senha, $banco) de 
acordo com suas configurações, Esse trecho de código faz uma conexão e algumas 
consultas ao banco de dados no qual se criou a tabela pesquisa. Seu funcionamento 
é bastante simples. Primeiro são definidas as linhas (times), ao selecionarmos os 
times distintos na tabela: 


select distinct(time) from pesquisa 


Em seguida, são definidas as colunas (anos), ao selecionarmos os anos distintos 
na tabela: 


select distinct(ano) from pesquisa « 


Por fim, para cada linha são obtidos os respectivos valores para cada coluna. 
Caso não exista um registro para uma determinada linha/coluna, seu valor será 
considerado zero. 


Pronto, agora seu programa irá gerar um gráfico de colunas com os dados obtidos 
de forma dinâmica. Experimente incluir novos registros na tabela pesquisa e observe 
os resultados. Como exemplo, vamos incluir mais oito registros na tabela: 


insert into pesquisa values ('Pelotas”, '2001', 20000); 
insert into pesquisa values ('Pelotas", '2002', 30000); 
insert into pesquisa values ('Pelotas", '2003', 40000): 
insert into pesquisa values ('Pelotas", "2004", 50000): 
insert into pesquisa values ('Grêmio", "2004", 850000); 
insert into pesquisa values ('Juventude”, "2004", 280000); 
insert into pesquisa values ('Inter', '2004', 150000); 
insert into pesquisa values ('Caxias", '2004', 95000); 


Após incluir os novos registros, acessando novamente a página PHP no programa 
navegador, você verá que o gráfico foi modificado, como mostra a figura 7.27. Incluí- 
ram-se uma nova linha (referente ao time Pelotas) e uma nova coluna (referente ao 
ano 2004), tudo de forma automática. 
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Um detalhe importante: no exemplo do programa grafico colunas .php, O array 
cores possui apenas quatro elementos, já que só havia quatro opções. Porém, se 
sua consulta for retornar mais de quatro opções, bastará acrescentar mais cores a 
esse array. 


Com os exemplos do livro no site da Novatec Editora, você encontrará um arquivo 
adicional chamado grafico. colunas. bd. php, que é praticamente o mesmo programa que 
O grafico. colunas.php, mas que contém essa alteração recém-sugerida para obtenção 
das informações a partir de um banco de dados. Se você pretende operar com banco 
de dados, utilize esse arquivo como referência. 


W costas 
. E trenio `- 


B inter 
“JO Juventude- 
Pelotas. 


Figura 7.27 — Gráfico de colunas gerado a partir de um banco de dados. 


Gráficos de linhas 


Após criarmos um programa que gera um gráfico de colunas, como foi feito no tópico 
anterior, torna-se fácil criar um que gere gráficos de linhas. Serão necessárias apenas 
algumas alterações no programa grafico. colunas .php. À estrutura básica do programa é 
a mesma, ou seja, o desenho dos eixos, pontos e legenda é feito exatamente da mesma 
forma. A única mudança é que, em vez de desenhar colunas, vamos desenhar linhas 
para representar a tendência dos dados. Considerando ainda o exemplo da pesquisa 
do time de futebol, veja na figura 7.28 o gráfico de linhas gerado pelo Excel. 
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—— Grêmio 
—e- Juventude 
Inter 


—— Caxias 


Figura 7.28 — Gráfico de linhas gerado no Excel. 


Veremos agora como gerar um gráfico semelhante no PHP. No gráfico de colu- 
nas, havíamos definido os dados da pesquisa (linhas, colunas e valores) nos arrays 
Stexto Tinha, $texto. coluna e $valores. Nesse exemplo, também será feito dessa forma. 
Será acrescentado apenas mais um array, O Sformatos, que irá indicar que figura 
geométrica (losango, quadrado ou triângulo) será desenhada para representar um 
ponto em uma linha, Assim, você poderá escolher uma figura para cada opção do 
gráfico. 


Acompanhe a seguir o programa grafico. linhas.php. Como sofreu apenas algumas 
alterações em relação ao exemplo anterior, vamos permanecer usando o mesmo arquivo 
de configuração (config grafico colunas. inc) utilizado para o gráfico de colunas: 


& grafico linhas.php 


<?php 

haader("Content-type: image/png"); 

// inclui o arquivo com as configurações 
include "config grafico colunas.inc'; 


!f cria imagem e define as cores 

$imagem = ImageCreate(Slargura, faltura); 

$fundo = ImageColorAlIocate(Simagem, 236, 226, 226); 
fpreto = ImageColorANocate(Simagem, 0, 0, 0); 

fazul = ImageColorATIocate(Simagem, O, 0, 255); 
Sverde = IrageColorAlTIocate(Simagem, 0, 255, 0); 
Svermetho = ImageColorATlocate(fimagem, 255, 0, 0); 
Samareto = ImageColorATiocate(Simagem, 255, 255, 0); 
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!4 definição dos dados 
// Vinhas representam os valores, colunas representam os intervalos 
ttexto. linha = array ("Gremio", "Juventude", “Inter”, “Caxias"); 
scores Jinha = array (Sazul, fverde, fvermelho, Samarelo); 
$formatos = array ("losango”, “quadrado”, "triangulo", "losango"; 
gtexto coluna = array ("2001", "2002", "20030; 
£valores = array ( 

510000, 525000, 650000, 

170000, 275000, 270000, 

460000, 300000, 170000, 

35000, 75000, 85000 

); 
$numero_linhas = sizeof($texto_tinha); 
$numero. colunas = sizeof ($texto_coluna); 
$nmero_valores = sizeof(Svalores); 
4! obtém os valores mínimo e máximo de y 
$y maximo = O; 
for ($i = 0; $i < $numero valores, $i++) 

if ($valores[$i] > Sy maximo) 

$y maximo = $valores[4i]; 


/! calcula o intervalo de variação entre os pontos de y 
&fator = pow (10, strlenCintval(£y maximo)) - 1); 
if CSy maximo < 1) 
$variacao = 0,1; 
elseif ($y maximo < 10) 
tvariacao = 1; 
elseif ($y Maximo < 2*$fator) 
$variacao = $fator / 5; 
elseif ($y maximo < 5*$fator) 
fvariacao = $fator / 2; 
elseif (ty maximo < 10*$fator) 
$variacao = $fator; 
4! calcula o número de pontos no eixo y 
fnum pontos eixo y = O; 


$valor = 0; 
while ($y maximo >= $valor) 
{ 


$valor += $variacao; 
$num pontos eixo y++; 
} 
$valor_topo = $valor; 
tdist entre pontos = $largura eixo y / num pontos eixo y; 


/f título 

ImageString(Simagem, 3, 3, 3, titulo, fpreto); 

fl eixos x ey 

ImageLine(timagem, Sinicio grafico x, Sinicio grafico. y, $inicio grafico x+$largura eixo x, 
$inicio grafico. y, Spreto); 

InageLine(Simagem, $inicio grafico x, $inicio grafico y, Sinicio grafico x, 
$início grafico y - Slargura eixo y, preto); 
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// pontos no eixo y 
4posy = Sinicio grafico y; 


valor = O; 


for ($i = 0; $i <= &num pontos eixo y; $i++) 


{ 
$posx = Sinicio grafico x - (strlen($valor}+2}*6; // 6 da largura da fonte + 2 espaços 
ImageString(Simagem, 2, $posx, $posy-7, valor, preto); 
ImageLine(Simagem, Sinicio grafico x-b, $posy, Sinicio grafico x+Slarguraeixo x, 
fposy, fpreto); 
valor += fvariacao; 
$posy -= $dist entre pontos; 
} 


/! imprime os labels 
$Slargura coluna = floor(flargura eixo x / fnumero colunas); 
fposx = finicio grafico x; 


for (fi = 0; $i < fnumero colunas; $i++} 


{ 
$pos_label_x = $posx + ($largura_coluna/2) - (strlen($texto_coluna[$i]) * 6 / 2); 
Spos Tabel y = $inicio grafico y + 10; 
ImageString(Simagem, 2, Spos. label x, $pos label y, Stexto coluna[$i], $preto); 
tposx += $largura coluna; 

} 


!/ desenha as tinhas 

for ($i = 0; $i < $numero_linhas; $i++) 

{ 
$posx = finicio grafico x + Slargura coluna/2; 
£primeiro ponto = true; 
$indice j = $i * $numero colunas; 


for ($j = Sindice j; $j < $indice j+fnumero colunas; $j++) 
{ 
if ($j > $indice_j) 
fprimeiro ponto = false; 
tposy = fvalores[$)]/fvalor-topo * $largura eixo..y; 
$posy = Sinicio.grafico y - fposy; 
if (!Sprimeiro ponto) 
ImageLine(Simagem, $ponto início x, Spontocinicio y, Sposx, $posy, 
Scores Vinha[$1]); 


/f desenha o ponto (de acordo com o formato definido) 
if ($formatos[$i] == "losango") 


{ 
fpontos = array(Sposx-4, $posy, $posx, $posy-4, $posx+4, fposy, $posx, Sposy+4); 
EmageFiVedPolygon(Simagem, $pontos, 4, $cores_Tinha[$i]); 

} 

elseif ($formatos[$i] == “quadrado”) 

{ 


ImageFilledRectangle($imagem, $posx-4, $posy-4, $posx+4, $posy+4, $cores_linha[$i]); 
} 


232 


} 


PHP para quem conhece PHP 


elseif {$formatos[$i] == “triangulo") 

{ 
pontos = array($posx-4, $posy+4, $posx, $posy-4, $posx+4, $posy+4); 
ImageFilledPolygon($imagem, Spontos, 3, $cores_linha[$i]); 

} 

$ponto_inicio_x = $posx; 

Sponto inicio y = $posy: 


fposx += Slargura coluna; 


} 


fi AREARE NERE CRIAÇÃO DA LEGENDA AWBR 
if Clexibir legenda == "sim" 


i 


} 


Z/ acha a maior string 
Smaior tamanho = 0: 
for (Si = 0; $i < $numero linhas; $i++) 
if Cstrlen($texto Tinha[$]) > Smaior tamanho) 
maior tamanho = strlentftexto. Vinha[$i]); 


ff calcula os pontos de início e Fim do quadrado 

ix inicio legenda = 51x - $larqura Fonte * (Smaior tamanhos4); 

Syinicio legenda = $ly; 

ix fim Tegenda = $1x; 

Sy Fim legenda = $ly + Snumero linhas * (Saltura fonte + Sespaco entre linhas) 
+ 2*fmargem vertica); 

ImageRectangie(Simagem, $x inicio Tegenda, Syinicio legenda, $x Fim legenda, 
$fy fim legenda, preto); . 


/! começa a desenhar os dados 
for ($i = 0; $i < numero Tinhas; $i++) 
Í 
Ex pos = x. inicio legenda + Slargura Fonte*3; 
$y_pos = Sy.inicio legenda + $i * (Saltura fonte + jespaco entre linhas) 
+ margem vertical; 
ImageString(Simagem, $fonte, $x pos, $y. pos, Stxto linha[$il, Spreto); 
ImageFilledRectangie (imagem, Ex pos-2*YMargura fonte, $y pos, 
ix pos-Slargura fonte, Sy pos+saltura fonte, Scores Jinha[35]); 
ImageRectangle (Simagen, ix pos-2*flargura fonte, fy pos, ix pos-$largura fonte, 
$y pos+faltura fonte, $preto); 
} 


ImagePng(Simagem): 
ImageDestroy(Simagem): 


7> 


Veja na figura 7.29 o resultado obtido ao executar o programa no navegador. 


Vejamos uma rápida explicação apenas sobre o trecho de código que desenha as 
linhas do gráfico, visto que os demais trechos já foram explicados no tópico anterior. 
Essa parte do programa consiste em dois laços com o comando for. O primeiro 
laço serve para percorrer as linhas (times) do gráfico, enquanto no segundo são 
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obtidos os respectivos valores para as colunas (anos) e, logo após, é traçada uma 
linha ligando os pontos referentes aos valores encontrados. 


Figura 7.29 — Gráfico de linhas gerado pelo programa grafico linhas.php. 


No array de valores, os dados de cada time encontram-se em seqiiência. Por 
exemplo, os dados referentes ao time “Grêmio” (texto. 1i nha[0]) estão nos elementos 
$valores (0), $valores(1), valores [2], os dados do time “Juventude” ($texto Tinha[1]) estão 
nos elementos $valores [3], $valores[4], $valores[5], € assim por diante. Por essa razão, 
a variável de controle do segundo laço (tj) deve iniciar como sendo um múltiplo 
da variável de controle do primeiro laço ($i): 


Sindice j = $i * numero colunas; 
for ($j = Síndice j; $j < Sindice jrônumero colunas; $j++) 


í 


Dentro desse laço foi usada uma variável lógica chamada $primeiro_ponto, pois 
quando estivermos posicionados no primeiro ponto, ou seja, no primeiro ano, não 
deverá ser traçada nenhuma linha, visto que para isso serão necessários, no mínimo, 
dois pontos. Essa variável é iniciada com o valor verdadeiro (TRUE), sendo alterada 
para falso (FALSE) na segunda iteração do laço for, por meio do seguinte teste: 


if ($j > Sindice j) 
iprimeiro pontosfalse; 


Logo após, a posição y do ponto é definida, sendo calculada como um percentual 
da medida do eixo y Esse valor é subtraído da posição y de início do gráfico, já que 
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quanto menor o valor de y mais acima estaremos desenhando. À partir da segunda 
iteração do laço for, a variável $primeiro. ponto já estará com o valor FALSE e o programa 
irá traçar uma linha iniciando no ponto anterior e terminando no ponto atual: 


Sposy = Svaloresj$j]/Svalor topo * Slargura eixo y; 
$posy = finicio grafico y - $posy; 
if (!Sprimeiro ponto) 
ImageLine(Simagem, fponto inicio x, fponto inicio y, Sposx, $posy, Scores Tinha(fi]); 


Em seguida é consultado o array $formatos, criado no início do programa, para 
definir qual figura geométrica será desenhada no local do ponto. Essas figuras 
geométricas (que no exemplo podem ser losangos, quadrados ou triângulos) são 
desenhadas com as funções ImageFiVledPolygon e ImageFiedRectangle, que já foram 
apresentadas neste capítulo. 


Ao final do laço, as coordenadas do ponto atual são armazenadas nas variá- 
veis Sponto inicio x e $ponto inicio y, para serem utilizadas como início do ponto 
seguinte(se houver). À posição x é atualizada para que o próximo ponto seja dese- 
nhado na coluna seguinte: 

$ponto. inicio x = 3posx; 


fponto inicio y = $posy; 
4posx += $largura coluna; 


Caso você queira gerar um gráfico de linhas obtendo os dados dinamicamente, 
por meio de um banco de dados, isso pode ser feito da mesma forma que no gráfico 
de colunas, como se explicou no tópico anterior. 


Funções do PHP para manipulação de imagens 


Além das principais funções que vimos neste capítulo, existem várias funções 
adicionais que nos permitem manipular imagens com a linguagem PHP A seguir, 
serão apresentadas as funções que podemos utilizar e uma pequena descrição de 
cada uma delas. 


exif imagetype 
Determina o tipo de uma imagem por meio da leitura de seus primeiros 
bytes. Retorna o identificador do tipo da imagem ou FALSE caso o tipo não 
seja reconhecido. 


int exif imagetype (string nome arquivo) 
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exif read data 


Lê os cabeçalhos EXIF de arquivos do tipo JPEG ou TIFE Retorna um array 
associativo, com os nomes dos cabeçalhos e os valores associados a estes. 


array exif read data (string nome arquivo [, string seções [, bool arrays 
[, bool thumbnai 11) 


exif. thumbnail 


Retorna a miniatura (thumbnail) embutida em uma imagem TIFF ou JPEG. 
Se a imagem não possuir uma miniatura embutida, retornará FALSE. 


string exif thumbnail (string nome arquivo [, int &largura [, int &altura 
[, int &tipo imagem]])) 


gd. info 


Retorna informações sobre a biblioteca GD atualmente instalada. Retorna um 
array associativo com informações sobre a versão e os recursos suportados. 


array gd info (void) 
getimagesize 


Obtém o tamanho de uma imagem. Retorna um array com quatro elementos. 
O primeiro contém a largura em pixels, o segundo contém a altura em 
pixels, o terceiro indica o tipo da imagem e o quarto contém uma string do 


tipo height="yyy” width="xxx", que pode ser usada diretamente na tag <img> da 
HTML. 


array getimagesize (string nome arguivo [, array info imagem) 


image type to mime type 


Obtém o tipo MIME de um tipo de imagem retornado pelas funções 
getimagesize, exif read data, exif thumbnail, exif imagetype. 


string image type to mime type (int tipoimagen) 
imageZwbmp 
Envia uma imagem do tipo WBMP para o navegador ou um arquivo. 


int imageZubmp (recurso imagem [, string nome arquivo [, int limiar]]) 


imagealphablending 
Define o modo de transparência de uma imagem. 


int imagealphablending (recurso imagem, bool modo) 
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imagearc 
Desenha uma elipse parcial na imagem passada como parâmetro. Os ângulos 
devem ser informados em graus. 
int imagearc (recurso imagem, int cx, int cy, int largura, int altura, 


int ang inicio, int ang fim, int cor) 


imagechar 


Desenha um caractere na imagem. Será desenhado apenas o primeiro caractere 
da string passada como parâmetro. 


int imagechar (recurso imagem, int fonte, int x, int y, string c, int cor) 


imagecharup 


Desenha um caractere na vertical. Será desenhado apenas o primeiro caractere 
da string passada como parâmetro. 


int imagecharup (recurso imagem, int fonte, int x, int y, string c, int cor) 


imagecolorallocate 


Aloca uma cor para uma imagem, retornando o identificador correspondente 
aos componentes RGB fornecidos. 


int imagecotorallocate (recurso imagem, int vermelho, int verde, int azul) 


imagecoloraliocatealpha 


Aloca uma cor para uma imagem. Similar à função imagecollorallocate, 
possuindo um parâmetro adicional para definir a transparência da imagem, 
que pode variar de 0 a 127. 


int imagecolorallocatealpha (recurso imagem, int vermelho, int verde, int azul, 
int transparência) 


imagecolorat 


Obtém o índice da cor de um pixel da imagem especificada. 
int imagecolorat (recurso imagem, int x, int y) 

imagecolorcosest 
Obtém o índice da cor mais próxima à cor especificada. 


int imagecolorclosest (recurso imagem, int vermelho, int verde, int azul) 
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imagecolorcosestalpha 


Obtém o índice da cor mais próxima à cor especificada, considerando o 
parâmetro de transparência. 


int imagecolorclosestalpha (recurso imagem, int vermelho, int verde, int azul, 
int transparência) 
imagecolorclosesthwb 


Obtém o índice da cor que possui o tom branco e preto mais próximo da 
cor especificada. 


int imagecolorclosesthwb (recurso imagem, int vermelho, int verde, int azul) 


imagecolordealtocate 


Desaloca uma cor para uma imagem. Essa cor deve ter sido previamente 
alocada com a função imagecolorallocate. 


int imagecolordeal locate (recurso imagem, int cor) 


imagecolorexact 


Obtém o índice de uma determinada cor. Se a cor especificada não existir na 
paleta da imagem, retornará -1. 


int imagecolorexact (recurso imagem, int vermelho, int verde, int azul) 


imagecolorexactalpha 


Obtém o índice de uma determinada cor, considerando o parâmetro de 
transparência. Se a cor especificada não existir na paleta da imagem, retornará 1. 


int inagecolorexactalpha (recurso imagem, int vermelho, int verde, int azul, 
int transparência) 


imagecolorresolve 


Obtém o índice da cor especificada ou a alternativa mais próxima possível. 


int imagecolorresolve (recurso imagem, int vermelho, int verde, int azul) 


imagecolorresolvealpha 


Obtém o índice da cor especificada, considerando o parâmetro de transparência, 
Se não encontrar, retornará a alternativa mais próxima possível. 


int imagecolorresolvealpha (recurso imagem, int vermelho, int verde, int azul, 
int transparência) 


imagecolorset 
Define a cor para um determinado índice de uma paleta. 


bool imagecolorset (recurso imagem, int índice, int vermelho, int verde, int azul) 
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imagecolorsforindex 


Obtém as cores de um determinado índice, Retorna um array associativo com 
as chaves red, green e blue, contendo os valores para o índice especificado. 


array imagecolorsforindex (recurso imagem, int índice) 


imagecolorstotal 
Retorna o número total de cores na paleta de cores de uma determinada 
imagem. 


int imagecolorstotal (recurso imagem) 


imagecolortransparent 
Define uma cor como transparente. Retorna o identificador da nova cor de 


transparência, ou da atual, caso nenhuma seja especificada. 


int imagecolortransparent (recurso imagem [, int cor]) 


imagecopy 
Copia parte de uma imagem para outra. 
int imagecopy (recurso img destino, recurso img origem, int dest. x, int dest y, 
int orig x, int orig y, int orig largura, int origaltura) 
imagecopymerge 
Copia e une parte de uma imagem com outra. As duas imagens serão unidas 


de acordo com o parâmetro perc, que deve ter um valor entre O e 100. Se o valor 
de perc for 100, o funcionamento será idêntico ao da função imagecopy. 


int imagecopymerge (recurso img dest, recurso img origem, int dest x, int dest. y, 
int orig x, int orig y, int orig largura, int origaltura, int pero) 


imagecopymergegray 
Copia e une parte de uma imagem utilizando tons de cinza. As duas imagens serão 
unidas de acordo com o parâmetro perc, que deve ter um valor entre O e 100, 


int imagecopymergegray (recurso img destino, recurso img origem, int dest x, int 
dest. y. int orig x, int orig y, int orig largura, int orig altura, int pero) 


imagecopyresampled 
Copia e redimensiona parte de uma imagem para outra. Faz a interpolação 


dos valores dos pixels de modo que se a imagem for reduzida, sua qualidade 
será mantida. 
int imagecopyresampled (recurso img destino, recurso img origem, int dest x, 


int dest y, int orig x, int orig.y, int dest largura, int dest altura, 
int orig largura, int orig altura) 
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imagecopyresized 


Copia e redimensiona parte de uma imagem para outra. Se as coordenadas 
e medidas origem e destino forem diferentes, será executado o aumento ou 
a redução apropriada. 


int imagecopyresized (recurso img destino, recurso img origem, int dest.x, int dest y, 
int origx, int origy, int dest Jargura, int destaltura, int orig largura, int 
orig altura) 
imagecreate 
Cria uma imagem e retorna seu identificador. Esse identificador deverá ser passado 
como parâmetro para outras funções que operam sobre essa imagem. 


recurso imagecreate (int tamanho x, int tamanho y) 


imagecreatefromgdZ 


Cria uma nova imagem a partir de um arquivo GD2 ou URL. Versões do PHP 
anteriores a 4.30 para Windows não suportam acesso a arquivos remotos 
com essa função. 


recurso imagecreatefromgdz (string nome arquivo) 


imagecreatefromgd2part 
Cria uma nova imagem baseada em uma parte de um arquivo GD2 ou URL. 
Versões do PHP anteriores a 430 para Windows não suportam acesso a 
arquivos remotos com essa função. 


recurso imagecreatefrongd?part (string nome arquivo, int orig x, int orig_y, int 
largura, int altura) 


imagecreatefromgd 


Cria uma nova imagem a partir de um arquivo GD ou URL. Versões do PHP 
anteriores a 430 para Windows não suportam acesso a arquivos remotos 
com essa função. 


recurso imagecreatefromgd (string nome arquivo) 


imagecreatefromgif 


Cria uma nova imagem a partir de um arquivo GIF ou URL. Versões do PHP 
anteriores a 430 para Windows não suportam acesso a arquivos remotos 
com essa função. O suporte ao formato GIF foi removido na versão 16 da 
biblioteca GD, já que o algortimo de compressão desse formato era patenteado 
pela Unisys. Portanto, se você pretende utilizar essa função, verifique a versão 
da GD que está utilizando. 


recurso imagecreatefromgif (string nome arquivo) 
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imagecreatefromjpeg 


Cria uma nova imagem a partir de um arquivo JPEG ou URL, retornando seu 
identificador. Versões do PHP anteriores a 430 para Windows não suportam 
acesso a arquivos remotos com essa função, 


recurso imagecreatefromjpeg (string nome arquivo) 


imagecreatefrompng 


Cria uma nova imagem a partir de um arquivo PNG ou URL, retornando seu 
identificador. Versões do PHP anteriores a 430 para Windows não suportam 
acesso a arquivos remotos com essa função. 


recurso imagecreatefronpng (string nome arquivo) 


imagecreatefromstring 


Cria uma nova imagem obtida a partir de uma string (image stream), 
retornando seu identificador. 


recurso imagecreatefromstring (string imagem) 


imagecreatefromwbmp 


Cria uma nova imagem a partir de um arquivo WBMP ou URL, retornando 
seu identificador. Versões do PHP anteriores a 430 para Windows não 
suportam acesso a arquivos remotos com essa função. 


recurso imagecreatefrombmp (string nome arquivo) 


imagecreatefromxbm 


Cria uma nova imagem a partir de um arquivo XBM ou URL, retornando seu 
identificador. Versões do PHP anteriores a 430 para Windows não suportam 
acesso a arquivos remotos com essa função. 


recurso imagecreatefromxbm (string nome arquivo) 


imagecreatefromxpm 


Cria uma nova imagem a partir de um arquivo XPM ou URL, retornando seu 
identificador. Versões do PHP anteriores a 4.30 para Windows não suportam 
acesso a arquivos remotos com essa função. 


recurso imagecreatefromxpa (string nome arquivo) 


imagecreatetruecolor 


Cria uma nova imagem true color (24 bits). Não funciona com o formato 
GIE 


recurso imagecreatetruecolor (int tamanho x, int tamanho y) 
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imagedashedline 
Desenha uma linha pontilhada. Essa função está obsoleta. Em vez de utilizá- 
la, faça uma combinação das funções imagesetstyle e imageline. 

imagedestroy 
Libera a memória alocada para uma imagem. 


int inagedestroy (recurso imagem) 


imageellipse 


Desenha uma elipse. Para desenhar parte de uma elipse, utilize a função 
imagearc. 


int imageellipse (recurso imagem, int cx, int cy, int largura, int altura, int cor) 


imagefill 


Preenche uma imagem com uma determinada cor a partir de um ponto 
especificado. 


int imagefill (recurso imagem, int x, int y, int cor) 


imagefilledarc 
Desenha uma elipse parcial, preenchendo-a com uma determinada cor. 


int imagefilledare (recurso imagem, int cx, int cy, int largura, int altura, 
int anginicio, int ang fim, int cor, int estilo) 


imagefilledellipse 

Desenha uma elipse, preenchendo-a com uma determinada cor. 

int imagefilledellipse (recurso imagem, int cx, int cy, int largura, int altura, int cor) 
imagefilledpolygon 

Desenha um polígono, preenchendo-o com uma determinada cor. 


int imagefilledpolygon (recurso imagem, array pontos, int num pontos, int cor) 


imagefilledrectangle 


Desenha um retângulo, preenchendo-o com uma determinada cor. 
int imagefiNedrectangle (recurso imagem, int xl,int y1,int x2, int y2, int cor) 
imagefilltoborder 


Preenche uma determinada região da imagem com a cor especificada. 


int imagefiltoborder (recurso imagem, int x, int y, int borda, int cor) 
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imagefontheight 
Retorna a altura, em pixels, do caractere da fonte especificada. 


int imagefontheight (int fonte) 


imagefontwidth 
Retorna a largura, em pixels, do caractere da fonte especificada. 


int imagefontwidth (int fonte) 


imageftbbox 


Obtém os limites do retângulo de um texto (bounding box) utilizando fontes 
do tipo Free Type?. 


array itageftbhox (int tamanho, int ângulo, string arg fonte, string texto 
[, array info extra]) 


imagefttext 
Escreve um texto em uma imagem usando fontes do tipo FreeType 2. 


array imagefttext (recurso imagem, int tamanho, int ângulo, int x, int y, int cor, 
string arg fonte, string texto [, array info extral) 


imagegammacorrect 

Aplica uma correção gama a uma imagem GD. 

int imagegammacorrect (recurso imagem, Float gama entrada, float gama saída) 
imagegd? 

Envia uma imagem GD2 para o navegador ou um arquivo. 

int imagegd? (recurso imagem [, string nome arquivo [, int tamanho bloco [, int tipo) 
imagegd 

Envia uma imagem GD para o navegador ou um arquivo. 

int imagegd (recurso imagem [, string nome arquivo]) 
imagegif 

Envia uma imagem GIF para o navegador ou um arquivo. O suporte ao 


formato GIF foi removido na versão 16 da biblioteca GD. Portanto, se você 
pretende utilizar essa função, verifique a versão da GD que está utilizando. 


int imagegif (recurso imagem [, string nome arquivol) 
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imageinterlace 


Habilita ou desabilita o entrelaçamento na imagem. A vantagem de utilizar a 
técnica do entrelaçamento é que a imagem aparece rapidamente, embora com 
resolução baixa. Após algum tempo, a imagem é exibida com resolução total. 


int imageinterlace (recurso imagem [, int entrelaçamento]) 


imageistruecolor 
Verifica se uma imagem é True color (24 bits). 
bool imageistruecolor (recurso imagem) 
imagejpeg 
Envia uma imagem JPEG para o navegador ou um arquivo. Permite ainda 


definir a qualidade da imagem, que pode variar de O (baixa qualidade, arquivo 
menor) a 100 (alta qualidade, arquivo maior). 


int imagejpeg (recurso imagem [, string nome arquivo L, int qualidadelT) 
imageline 
Desenha uma linha na imagem. 


int imageline (recurso imagem, int x), int y1, int x2, int y2, int cor) 


imageloadfont 


Carrega uma fonte definida pelo usuário, retornando seu identificador. 
Esse identificador será sempre maior que 5, visto que os valores de 1a 5 são 
reservados para as fontes-padrão. 


int imageloadfont (string arquivo) 


imagepalettecopy 

Copia a paleta de cores de uma imagem para outra. 

int imagepalettecopy (recurso img destino, recurso img origen) 
imagepng 

Envia uma imagem PNG para o navegador ou um arquivo. 


int imagepng (recurso imagem [, string nome arquivo]) 


imagepolygon 
Desenha um polígono na imagem. Permite definir a cor da borda. 


int imagepolygon (recurso imagem, array pontos, int num pontos, int cor) 
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imagepsbbox 
Obtém os limites do retângulo de um texto (bounding box) utilizando fontes 
do tipo PostScript Typel. 


array imagepsbbox (string texto, int fonte, int tamanho E, int espaco [, int densidade 
[, float ângulo]]) 


imagepscopyfont 
Faz uma cópia de uma fonte já carregada para realizar modificações 
posteriores. 


int imagepscopyfont (int índice fonte) 


imagepsencodefont 


Modifica a codificação (encoding vector) dos caracteres de uma fonte. 


int imagepsencodefont (int índice fonte, string arg codificação) 


imagepsextendfont 


Estende ou condensa uma fonte. Se o valor fornecido for menor do que o 
atual, a fonte será condensada. 


bool imagepsextendfont (int índice fonte, float novo alor) 


imagepsfreefont 
Libera a memória utilizada por uma fonte do tipo PostScript Type 1. 


void imagepsfreefont (int indice. fonte) 


imagepsloadfont 
Carrega uma fonte do tipo PostScript Type 1 a partir de um arquivo. 


int imagepsloadfont (string nome arquivo) 


imagepsslantfont 


Define a inclinação de uma fonte. 


bool imagepsslantfont (int índice fonte, float inclinação) 


imagepstext 
Desenha um texto em uma imagem usando fontes do tipo PostScript Typel. 


array imagepstext (recurso imagem, string texto, int Fonte, int tamanho, int cor texto, 
int cor fundo, int x, int y [, int espaço [, int densidade [, float ângulo 
É, int num cores antialias]]]) 
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imagerectangle 
Desenha um retângulo na imagem. Permite definir a cor da borda. 


int imagerectangle (recurso imagem, int x1, int yl, int x2, int y2, int cor) 


imagerotate 


Realiza uma rotação em uma imagem, considerando o ângulo especificado. 


recurso imagerotate (recurso img origem, float ângulo, int cor fundo) 


imagesavealpha 


Usada em imagens PNG para configurar a flag que indica se as informações 
sobre o canal alfa (alpha channel) devem ser salvas. 


bool imagesavealpha (recurso imagem, bool flag) 


imagesetbrush 


Define a imagem do pincel (brush) para o desenho de linhas. 


int imagesetbrush (recurso imagem, recurso pincel) 


imagesetpixel f 
Desenha um simples pixel na imagem. 


int imagesetpixel (recurso imagem, int x, int y, int cor) 


imagesetstyle 
Define o estilo para o desenho de linhas. 


int imagesetstyle (recurso imagem, array estilo) 


imagesetthickness 
Define a espessura para o desenho de linhas. 


void imagesetthickness (recurso imagem, int espessura) 


imagesettile 
Define a imagem a ser usada pelas funções de preenchimento (como imagefi11, 
por exemplo) quando for utilizada a cor especial IMG COLOR TILED. 


int imagesettile (recurso imagem, recurso img preenchimento) 
imagestring 
Escreve um texto na imagem, da esquerda para a direita. 


int imagestring (recurso imagem, int fonte, int x, int y, string texto, int cor) 
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imagestringup 
Escreve na imagem um texto na vertical, de baixo para cima. 


int imagestringup (recurso imagem, int fonte, int x, int y, string texto, int cor) 


imagesx 
Retorna a largura (em pixels) de uma imagem. 


int imagesx (recurso imagem) 


imagesy 
Retorna a altura (em pixels) de uma imagem. 


int imagesy (recurso imagem) 


imagetruecolortopalette 


Converte uma imagem True color (24 bits), que passará a ser baseada em uma 
determinada paleta de cores. Permite habilitar uma técnica chamada dither, 
que combina a cor dos pixels da imagem para obter uma cor aproximada na 
paleta resultante. 


void imagetruecolortopalette (recurso imagem, bool dither, int num cores) 


imagettfbbox 


Obtém os limites do retângulo de um texto (bounding box) utilizando fontes 
TrueType. 


array imagettfbbox (int tamanho, int ângulo, string arquivo fonte, string texto) 


imagettftext 
Escreve um texto em uma imagem usando fontes TrueType. 
array inagettftext (recurso imagem, int tamanho, int ângulo, int x, int y, int cor, 
string arquivo fonte, string texto) 

imagetypes 
Retorna um valor inteiro que representa os tipos de imagens suportados pela 
compilação atual do PHP. Esse valor deve ser comparado de forma binária 


(&r) com a constante referente ao tipo de imagem que se deseja verificar. As 
constantes são IMG GIF, IMG JPG, IMG PNG, IMG WBMP. 


int imagetypes (void) 
imagewbmp 
Envia uma imagem WBMP para o navegador ou um arquivo. 


int imagewbmp (recurso imagem [, string nomearquivo [, int corl]) 
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iptcembed 

Embute dados binários IPTC em uma imagem JPEG. 

array iptcenbed (string dados iptc, string nome arq jpeg [, int spoot]) 
iptcparse 


Faz a análise (parse) de um bloco binário IPTC (http://www. iptc.org) em tags 
simples. 


array iptcparse (string bloco iptc) 
jpeg2wbmp 
Converte uma imagem JPEG para o formato WBMP. 
int jpeg2wbmp (string nome jpeg, string nome nbmp, int dest altura, int dest largura, 
int limiar) 
png2wbmp 
Converte uma imagem PNG para o formato WBMP. 
int pngzwbmp (string nome png, string nome wbmp, int dest.altura, int dest. largura, 
int limiar) 
read exif data 


Apelido (alias) para a função exif read data. 


À versatilidade dos documentos PDF 


Neste capítulo, você irá aprender a utilizar o PHP para gerar documentos no formato 
PDF (Portable Document Format). Serão apresentados todos os passos básicos para 
a criação desses documentos, assim como os principais recursos disponíveis na 
biblioteca PDFlib, como formatação, caixas de texto, modelos, inserção de imagens, 


entre outros, Serão apresentados também aplicações que podem ser criadas usando 
a PDFlib, além de alguns exemplos utilizando a biblioteca alternativa FPDF 


Por que criar documentos PDF? 


O formato PDF foi criado pela Adobe (http: //wmy.adobe. com) e vem sendo utilizado 
com sucesso há mais de uma década para a distribuição de documentos eletrôni- 
cos em todo o mundo. Para abrir e imprimir um arquivo PDF, basta ter o software 
Adobe Acrobat Reader, que está disponível gratuitamente para download no site 
da Adobe. 


Diversas empresas e órgãos governamentais do mundo inteiro adotaram o PDF 
para melhorar o gerenciamento de documentos e aumentar a produtividade. Pode- 
se citar como exemplo a justiça federal americana, que adotou esse formato como 
padrão para o registro eletrônico dos processos, assim como o governo alemão, 
que utiliza arquivos PDF para realizar a troca eletrônica de documentos (normas, 
formulários, relatórios, notas para a imprensa, clippings e cartas). 


Também é comum o uso do formato PDF na área jurídica. Vários escritórios de 
advocacia, cartórios e tribunais utilizam-no para armazenar e distribuir documen- 
tos, tais como processos, contratos, cadastros, requerimentos, patentes, apelações, 
boletins de ocorrêncis, entre outros. 


Entre as vantagens desse formato, pode-se destacar o controle preciso sobre o 
posicionamento de elementos na página e, consegiientemente, sobre a impressão 
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do documento. É possível também inserir imagens e referências no documento, seja 


por meio de links, bookmarks ou thumbnails, conforme veremos mais adiante. 


Veja a seguir uma tabela publicada pela Adobe, que lista alguns problemas dos for- 


matos atuais e apresenta, para cada um deles, a solução existente no formato PDF. 


Tabela obtida no site http://www. adobe, com.br. 


PROBLEMAS COMUNS 


Os destinatários não conseguem abrir os arquivos, 
pois não dispõem dos aplicativos usados para criar os 
documentos. 


A combinação de arquivos impressos e eletrônicos 
dificulta a pesquisa, toma espaço e requer que o 
aplicativo usado para criar um documento esteja 
disponivel para acesso futuro. 


| 


SOLUÇÕES DO ADOBE POF 


Qualquer pessoa, em qualquer lugar, pode abrir um 
arquivo PDF, Tudo o que você precisa é do software 
gratuito Adobe Reader. 

Os arquivos PDF são compactos, podem ser 
pesquisados com facilidade e acessados a qualquer 
tempo usando o Adobe Reader. Os hiperlinks 
interativos permitem fácil navegação nos arquivos PDF. 


Os documentos não são exibidos corretamente em 
dispositivos portáteis, 


As tags do PDF permitem refluxo automático do texto 
para exibição em plataformas móveis, tais como 
dispositivos Palm OS, Symbian e Pocket PC. 


As empresas acabam usando papel na troca de 
documentos e formulários devido à falta de processos 
eletrônicos de fácil verificação e auditoria. 


È possivel especificar direitos de acesso especiais aos 
documentos PDF, assim como assinaturas digitais. 


Documentos com formatação complexa não podem ser 
lidos por usuários com deficiência visual, 


Os arquivos PDF marcados por tags contêm 
informações sobre o conteúdo e estrutura, podendo ser 
lidos com a ajuda de leitores de tela. 


A linguagem PHP possibilita a criação e exibição de documentos PDF na web. 


Esse é um recurso bastante útil que você pode usar de acordo com o tipo de docu- 
mento a ser entregue a seus usuários. Vejamos algumas alternativas de uso do PHP 


para trabalhar com arquivos PDFs: 


= Geração de relatórios: uma das aplicações mais interessantes que podem ser 
criadas com as funções PDF do PHP é a geração dinâmica de relatórios, 
baseada em informações obtidas de um banco de dados. Por exemplo, um 


site que vende produtos de diversas categorias poderia permitir ao usuário 
gerar um relatório de preços em formato PDF, contendo somente produtos 


de determinadas categorias. Veremos mais adiante como criar um programa 
que monta um relatório a partir de uma consulta SQL (SQL query) a um 


banco de dados. 


Comércio eletrônico: a emissão de faturas por sites de comércio eletrônico pode 


ser feita perfeitamente por meio de documentos PDF. 


Impressão: o formato PDF é ideal para a criação de qualquer documento que 


necessite de um controle preciso sobre sua impressão. Isso porque, ao contrário 
de outros formatos, em um documento PDF o que você vê na tela é o que 


verá na impressora. Ou seja, a versão eletrônica e a impressa terão exatamente 
o mesmo aspecto. Os formulários podem ser citados como exemplo, pois 
podemos definir de forma precisa o posicionamento de seus campos. 
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Introdução à biblioteca PDFlib 


Para criar documentos em formato PDF no PHP é necessária uma biblioteca que 
forneça esse suporte. A biblioteca mais utilizada é a PDFlib. As versões a partir da 
40 da PDFlib são suportadas desde o PHP 430, A versão completa dessa biblioteca 
está disponível para download no site http: //wm. pdfiib. com/, mas requer a compra de 
uma licença para uso comercial. Existe, porém, a PDFlib Lite, uma versão que pode 
ser usada gratuitamente sob certas condições. 


A configuração da PDFlib no Unix/Linux consiste em compilar o PHP com 
suporte a essa biblioteca, enquanto no Windows a extensão está disponível em um 
arquivo dll, que precisa ser colocado no diretório das extensões do PHP e habilita- 
do no arquivo de configuração php. ini. Caso você tenha dificuldades na instalação, 
consulte o roteiro disponibilizado no site pessoal do autor, no endereço: 


http://www. niederauer.com.br/Tivros/phpavancado/ rotei roPDF .hta] 


Formas alternativas: Haru e FPDF 


Existem várias bibliotecas alternativas que podem ser utilizadas para a geração 
de documentos PDF. A Haru é uma delas. Trata-se de uma biblioteca gratuita que, 
assim como a PDFlib, está disponível como uma extensão do PHP, podendo ser 
obtida na PECL (PHP Extension Community Library — pecl.php.net). Outra alter- 
nativa bastante interessante é a FPDF, disponível no endereço http: //wmu. fpdf.org. A 
grande vantagem da FPDF é que está disponível em forma de um classe PHP Isso 
significa que você não precisa ter nenhuma extensão instalada nem configurada. 
Basta colocar os arquivos da classe em seu servidor e inserir uma chamada para 
ela no início de seus programas. 


Por ser a extensão mais utilizada, os exemplos que serão apresentados nesse 
capítulo estão baseados na PDFlib. Porém, ao final do capítulo veremos também 
exemplos utilizando a FPDF, para que você entenda como funciona essa classe, caso 
a considere a melhor alternativa para uma determinada situação. 


Diferenças entre versões do PHP 


Antes de iniciarmos a programação, é importante destacar que o modo de progra- 
mar irá depender da versão do PHP utilizada. A biblioteca PDFlib, a partir de sua 
versão 6, passou a oferecer uma sintaxe orientada a objetos para satisfazer o modelo 
do PHP 5, enquanto a sintaxe orientada a funções continua valendo para o PHP 4. 
As principais diferenças são as seguintes: 
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No PHP 4, primeiro se deve criar um ponteiro PDF com uma chamada do tipo: 
$pdf = pdf_new(). 


Esse ponteiro será usado como primeiro parâmetro nas chamadas seguintes. 
Por exemplo: 


pdf_begin_document($pdf, "", ""). 
Já no PHP 5, um objeto PDFIib é criado da seguinte forma: 
$pdf = new PDFIbO. 


Por meio desse objeto, chamam-se as funções PDFlib como métodos. Por exemplo: 


wu ear 


$pdf->begin. document (", “9, 


Utilizaremos neste livro a sintaxe mais atual, 


Criando um arquivo PDF 


Para criar um arquivo PDF, utilizando a biblioteca PDFlib, são necessários dois 
passos iniciais: 


1. o comando new PDF1ibO para criar um objeto PDF; 
2. o método begin document para criar o arquivo PDF. 


A chamada new PDF1ib0 não tem parâmetros de entrada e retorna o ponteiro para 
o objeto PDF criado. Esse objeto será utilizado na chamada de todos os métodos que 
operam sobre o documento. O método begin document possui a seguinte sintaxe: 


int begin document(string nome arquivo, string lista opções). 


Parâmetro Descrição 

nome. arquivo Nome do arquvo PDF a ser criado. Se não for fornecido, o documento 
será gerado em memória em vez de em um arquivo. 

Vista opções Opções a ser passadas ao método. Você pode passar uma string 
vazia (““) se não houver opções. 


Observe, então, o código a seguir, que cria um novo objeto PDF e, logo após, 
gera um arquivo chamado teste.pdf a partir desse objeto. Considere os três pontos 
(..) como um trecho de código que no momento não vem ao caso: 

<?php 


pdf = new PDFTibO; 
$pdf->begin document ("teste. pdf”, ""); 


T> 
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As propriedades do documento 


A definição das propriedades não é obrigatória. No entanto, é bastante comum 
gravar as informações sobre um documento, como o nome do autor, nome do cria- 
dor, título, entre outras. Essa informações serão visualizadas pelo usuário quando 
ele acessar as propriedades do documento no software Acrobat Reader. O método 
set info é responsável por definir essas propriedades: 


bool set.info (string propriedade, string valor) 


Parâmetro Descrição 


propriedade Nome da propriedade a ser definida. Pode assumir os valores “Subject”, 
“Title”, “Creator”, “Author”, “Keywords” ou alguma outra propriedade 
criada pelo usuário. 


valor Valor a ser definido para a propriedade. 


Prosseguindo com o trecho de código do tópico anterior, vamos acrescentar 
algumas linhas para definir as propriedades do documento teste, pdf: 

<?php 

$pdf = new POFTib(}); 

fpdf->begin document ("teste.pdf”, “O; 

$pdf->set info(" Author”, "Juliano Niederauer"); 

Spdf->set infoC"Title", “Documento teste“); 


pdf->set info" Creator", "Juliano Niederauer”); 
fpdf->set_info("Subject", "Meu primeiro documento PDF"); 


?> 


Adicionando páginas:ao documento 


Após criar o documento PDF e definir suas propriedades, você já pode começar 
a criar as páginas desse documento. Iniciamos uma página utilizando o método 
begin page ext e a encerramos com ‘o método end.page ext. A sintaxe do método _be- 
gin page ext é apresentada a seguir: 


bool begin page ext (Float largura, float altura, string lista opções) 


Parâmetro Descrição 


largura Largura da página a ser criada. O valor deve ser em pontos (um ponto 
equivale a 1/72 de uma polegada). 


altura Altura da página a ser criada. O valor deve ser em pontos (um ponto 
equivale a 1/72 de uma polegada). 

Vista opções Opções a ser passadas ao método. Você pode passar uma string vazia 
(©) se não houver opções. 


Capítulo 8 = A versatilidade dos documentos PDF 253 


Em todos os nossos exemplos, vamos criar páginas no tamanho A4 (595 x 842). 
Porém, existem outros tamanhos comuns de páginas, como mostrado na tabela a 


seguir: 
Formato | Largura Altura 
— 
33 
AQ 1 2380 | 68 
ÀS 1684 2380 
A2 1190 E 1684 
| — 
A3 842 na 1190 
EM El 595 842 
| A5 421 | 
=] 
AG 297 421 
B5 501 709 
letter (8.5"x117 612 792 
pas 5x1) - L 
legal {8.F x1) 612 1008 
24 
ledger {17"x11"} 1224 792 
11x17" 792 1224 


Para finalizar uma página, utilizamos o método end_page_ext, que possui a sintaxe 
apresentada a seguir: 


bool end_page_ext (string lista opções) 


Portanto, prosseguindo com o trecho de código do tópico anterior, a estrutura 
do programa ficará da seguinte forma: 

<?php 

$pdf = new PDFTIDO; 

$pdF->begin document (teste. pdf”, “9; 

$pdf->set info("Author”, "Juliano Niederauer"): 

$pdf->set .info(" Title”, "Documento teste"); 


$pdf->set. info(" Creator”, “Juliano Niederauer"); 
tpif->set info(" Subject", "Meu primeiro documento PDF"): 


Spdf->hegin page ext(595, 842, ""); 

$pdf->end, page. ext("") ; 

> 

Entre os métodos begin page ext € end page ext, devemos definir o conteúdo da 
página, como veremos em seguida. 
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Escolhendo o tipo e o tamanho da fonte 


Após criar uma página no documento, antes de inserir qualquer texto, devemos 
escolher a fonte a ser utilizada. A escolha da fonte é feita em duas etapas: 


1. A fonte é carregada com o método load font. 
2. A fonte é escolhida, com seu tamanho, com o método setfont. 
A sintaxe do método lead font é a seguinte: 


int load font (string nome fonte, string codificação, int lista opções) 


Parâmetro Descrição 


nome.fonte Nome da fonte a ser carregada. 


codificação Codificação de caracteres a ser utilizada. Pode assumir os valores 
“buiTtin” “ebedic” “macroman”, “winansi” “host” ou alguma outra codifi- 


cação definida pelo usuário. 


lista opções Opções a serem passadas ao método. Você pode passar uma string vazia 
(““) se não houver opções. 


A seguir, alguns nomes de fontes embutidas que você pode utilizar para o pa- 
râmetro nome. fonte: 


Courier Courier-Bold 

Courier-Oblique  Courier-Bold0blique 
Helvetica Helvetica-Bold 
Helvetica-Oblique Helvetica-BoldOblique 
Times New Roman Times-Bold 
Times-Italic Times-BoldItalic 

Symbol ZapfDingbats 


Em relação à codificação dos caracteres (terceiro parâmetro), a descrição de cada 
um dos valores possíveis é apresentada a seguir: 


Codificação Descrição 

winansi Página de código 1252 do Windows. Subconjunto do ISO 8859-1. 
macroman Codificação de caracteres-padrão do Macintosh. 

ebcdic Codificação EBCDIC usada em sistemas IBM AS/400 e 5/390. 
buittin Codificação original usada por fontes não-texto (symbol). 

host macroman no Macintosh, ebedic em sistemas baseados no EBCDIC e 


winansi para os demais. 


Com o método lead font, preparamos a fonte para uso e obtemos seu identificador. 
Para definir essa fonte como sendo a fonte corrente, basta utilizar o método setfont: 


bool setfont (int fonte, float tamanho) 
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Parâmetro Descrição 
fonte Identificador da fonte, retornado pela função pdf. findfont. 
tamanho Tamanho da fonte, em pixels. 


Portanto, para configurar uma fonte para uso, são necessários esses dois coman- 


dos. Se quiséssemos, por exemplo, utilizar a fonte Times New Roman com tamanho 16, 


acrescentaríamos mais duas linhas a nosso programa: 


<?php 

$pdf = new PDFTIDO); 

$pdf->begin. document ("teste.pdf", ""); 

Spdf->set infoC" Author", "Juliano Niederauer"); 

&pdf->set info("Title", "Documento teste"); 

$pdf->set info("Creator", “Juliano Niederauer"); 

$pdf->set info("Subject", "Meu primeiro documento PDF"); 

$pdf->begin page ext(595, 842, "9; 
fonte = $pdf->1vad font("Times New Roman”, “winansi”, ""); 
&pdf->setfont(Sfonte, 16); 


$pdf->end page ext(""D; 


?> 


Inserindo o conteúdo 


Com a página criada e a fonte corrente definida, você já pode começar a escrever no 
documento. Porém, o texto é apenas um dos muitos tipos de conteúdos que podem 


ter em um arquivo PDF É possível também inserir caixas de texto, links, imagens, 


desenhar figuras, linhas etc, 


A forma mais básica de escrever no documento é com os métodos show (que es- 


creve um texto na posição corrente) e show xy (que escreve um texto nas coordenadas 


especificadas): 
bool show (string texto) 


bool show xy (string texto, float x, float y) 


Parâmetro Descrição 

texto Texto a ser escrito no documento. 

x Coordenada x do ponto onde o texto será escrito. 
y Coordenada y do ponto onde o texto será escrito. 


Por exemplo, para escrever o texto “Este é meu primeiro documento PDF!!!” no 


ponto (150,750) do documento, basta utilizar a seguinte linha: 


$pdf->show xy ("Este é o meu primeiro documento PDOF!!!", 150, 750); 
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No decorrer deste capítulo, veremos como configurar os atributos do texto, assim 
como inserir os principais tipos de conteúdo em um documento PDF. Lembre-se 
de que o conteúdo deve ser sempre inserido entre os comandos begin page ext € 
end page ext. 


Fechando o documento e liberando a memória 


Ao terminar um documento, devemos fechá-lo para que sejam liberados os recursos 
internos alocados para ele. Para isso, utilizamos o método end document: 


bool end document (int Tista opções) 


Definindo o destino do documento gerado 

Você tem duas opções para definir o destino do documento PDF gerado: 
1. Gravá-lo em um arquivo. 
2. Enviá-lo diretamente ao programa navegador. 


Para gravá-lo em um arquivo, utilize o primeiro parâmetro do método begin. 
document para definir o nome desse arquivo. Por exemplo: 


Spdf->begin. document "teste, pdf", “3; 


Dessa forma, o arquivo teste, pdf será salvo no servidor e você poderá colocar um 
link para o usuário acessá-lo. O programa ficará, então, semelhante ao mostrado 
a seguir. Tal programa nomeado como primeiro.php criará um documento PDF de 
uma única página e escreverá o texto “Este é o meu primeiro documento PDF!!!” 
nessa página: 


primeiro.php 


<?php 
Sarquivo = 'teste.pdf'; 
$pdf = new PDETIDO; 
/! abre um novo arquivo PDF 
if (£pdf->begin. document (Sarquivo, "") == 0) { 
die{"Erro: " . $pdf->get errasg0); 
} 
$pdf->set_info{"Author", "Juliano Niederauer“): 
$pdf->set_info("Title", "Documento teste"); 
$pdf->set_info("Creator", "Juliano Niederauer"): 
$pdf->set info("Subject”, "Meu primeiro documento PDF"): 
$pdf->begin page ext(595, 842, ""); 
Sfonte = $pdf->1oad Tont("Times New Roman", "winansi", ""); 
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Spdf->setfont(Sfonte, 16); 
Spdf->shom xy("Este é o meu primeiro documento PDF!!!", 150, 750); 
$pdf->end page ext(""); 
$pdf->end document (""): 
echo “Arquivo <b>Sarquivo</b> criado!"; 
echo "<br><a href=Sarquivo>Clique aqui para acessá-lo</a>"; 
?> 


Para evitar erros na geração do arquivo, verifique se a pasta na qual você está 
tentando gravá-lo possui permissão de escrita. Procure também especificar o cami- 
nho (diretório) completo para gravação do arquivo, evitando que este seja gravado 
na raiz de documentos do servidor. 


A segunda opção para gerar um arquivo PDF, que consiste em criar o documento 
em memória e enviá-lo direto ao navegador do usuário, também é bastante utili- 
zada. Se você for utilizá-la, primeiramente omita o nome do arquivo no método 
begin document: 


$pdf->begin document ("", "")}; 


Ao final do programa, você deve obter o conteúdo do objeto PDF e enviá-lo ao 
programa navegador. O comando header do PHP deve ser utilizado para informar ao 
navegador o tipo de conteúdo que irá receber, assim como o tamanho deste. Para 
obter o conteúdo de um objeto PDF, utiliza-se o método get buffer. 


Portanto, se quiséssemos exibir o documento gerado diretamente na tela do 
usuário, deveriam ser acrescentadas as seguintes linhas após o encerramento do 
documento: 


$buf = $pdf->get buffer); 

Stamanho = strlen(Sbuf); 

header ("Content-type application/pdf"); 
haader("Content-Langth: Stamanho" ; 

header("Content -Disposition:sinline; filename=arquivo. pdf"); 
echo Sbuf; 


Note que se utilizou o comando header para enviar três cabeçalhos ao navegador 
do usuário: 


Cabeçalho Descrição 
Content-type Tipo de conteúdo que está sendo enviado. 
Content-Length Tamanho dos dados que estão sendo enviados. 


Content-Disposition Como o conteúdo deve ser exibido. 


Vamos utilizar esse segundo método nos exemplos que veremos neste capítulo, 
visto que normalmente não há necessidade de manter uma cópia do documento 
PDF gerado no servidor. 
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Sistema de coordenadas 


No sistema de coordenadas de um documento PDF, o ponto (00) corresponde ao 
canto inferior esquerdo da imagem. Para uma página tamanho A4, por exemplo, 
teríamos: 


(595,842) 


(0,0) 
Figura 8.1 — Sistema de coordenados original. 


Como exemplo, considere o programa coordenadas .php em que se utiliza o méto- 
do show. xy para escrever um texto em cada um dos quatro cantos do documento e 
também no centro deste: 


coordenadas.php 


<?php 

$p = new PDFlib; 

if CSp->begin document("", ""} == ©) { 
die("Erro: " . $p->get_errmsg0); 

} 

Sp->set info("Creator”,"coordenadas. php"); 

Sp->set. info("Author","Jutiano Niederauer"); 

Sp->set info("Title”,"Sistema de coordenadas"); 

Sp->begin page ext(595, 842, "9; 
Sfont = $p->10ad font("Helvetica-Bold","winansi","O; 
Sp->setfont($font,28.0); 
$p-sshow xy( “Inferior esquerdo”, 10, 10); 
$p->show xy( “Inferior direito”, 400, 10); 
&p->show xy( "Superior esquerdo", 10, 802); 
4p->show xy( "Superior direito”, 370, 802); 
$p->show xy( “Centro",595/2-50,842/2-14); 

$p->end page ext(""); 

$p->set parameter("openaction", “fitpage"); 

Sp->end docunent (9; 

$buf = $p->get bufferO; 

ftamanho = strlen(ibuf); 

header ("Content-type application/pdf"); 

header ("Content-Length: $tamanho") ; 

header ("Content-Disposition:inline; filename=coordenadas. pdf"); 

echo $buf; 

?> 
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Note que nesse exemplo, antes de encerrar o documento, foi usada uma função 
chamada pdf. set. parameter para configurar a propriedade "openaction". Isso foi feito 
apenas para que o documento possa ser visualizado em uma só tela. Ao executar 
esse programa no navegador, será exibido o documento PDF gerado, como mostra 
a figura 8.2. 


Superior esquerdo Superior direito 


Inferior esquerdo 


Figura 8.2 — Documento gerado pelo programa coordenadas. php. 


Esse é o sistema de coordenadas original. Porém, se você estiver acostumado a 
tratar o ponto (00) como sendo o ponto superior esquerdo do documento (assim 
como considerávamos no capítulo sobre imagens), existe a possibilidade de mover 
a origem do sistema de coordenadas. Vamos supor, então, que você queira trabalhar 
com o seguinte sistema: 


(0,0) 


(595,842) 


Figura 8.3 — Sistema de coordenados alternativo. 
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Para utilizar esse novo sistema, precisaremos utilizar três métodos em segiiência: 
1. translate para mover a origem; 
2. scale para fazer o valor de y variar no sentido oposto (de cima para baixo); 
3. set value para alterar a escala horizontal (mirror). 


Acompanhe, então, o programa coordenadas2. php apresentado a seguir. Logo após 
a criação da página, o sistema de coordenadas é alterado com o uso desses três 
comandos e, logo depois, é escrito um texto no canto superior esquerdo: 


coordenadas2.php 


<?php 
$p = new PDFTIDO; 
if (3p->begin document("", "") == 0) { 
dieC'Erro: | . $p->get_erresg()); 
H 
$p->set_info("Creator","coordenadas2. php); 
fp->set info("Author", "Juliano Niederauer"); 
&p->set infol"Title", "Sistema de coordenadas”); 
$p->begin page ext(595, 842, "9; 
ff move a origem 
Sp->translate(D, 842); 
Sp->scale(l, -1); 
fp->set value("horizscaling",-100); 
Sfont = $p->load Ffont("Helverica-Bold", "winansi", ""}: ! 
Sp->setfont(Sfont,-38.0); 
Sp->show xyC "Superior esquerdo”, 10, 40); 
tp->end page ext(""): 
$p->set parameter("openaction", "fitpage"); 
Sp->end document (""); 
$buf = $p->get buffer(); 
$tamanho = strlen($buf); 
header("Content-type application/pdf"); 
header ("Content-Length : $tamanho"); 
header("Content-Disposition:inline; Filename=coordenadas. pdf"); 
echo $buf; 
7> 


Ao acessar o programa pelo navegador, você verá as palavras “Superior esquerdo” 
escritas a partir do ponto (1040), que agora representa o canto superior esquerdo 
do documento. 
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Inserindo caixas de texto no documento 


Caixas de texto são interessantes porque permitem definir não só os limites para 
um determinado bloco de texto, mas também um alinhamento para este. O método 
utilizado para criar caixas de texto é o create textflow, que tem a seguinte sintaxe: 


int create textflow (string texto, string lista opções) 


Parâmetro Descrição 
texto Texto a ser escrito no documento. 
lista opções Opções relativas à exibição do texto, como, por exemplo, as fontes 


e o alinhamento. 


Essa função retorna um número inteiro que representa o identificador do objeto 
criado. Por fim, para definirmos os limites dessa caixa de texto, precisamos executar 
o método fit textflow, cuja sintaxe é: 


int fit textflow (int objeto, float iex, float iey, float sdx, float sdy, string opções) 


Parâmetro Descrição 

objeto Objeto da caixa de texto, criado pelo método create. textílow. 

iex Coordenada x do canto inferior esquerdo da caixa de texto. 

iey Coordenada y do canto inferior esquerdo da caixa de texto. 

sdx Coordenada x do canto superior direito da caixa de texto. 

sdy Coordenada x do canto superior direito da caixa de texto. 

opções Lista de opções para o método. Utilize uma string vazia se não houver 
opções. 


* Essa função é suportada apenas pela versão completa da PDFlib. 


É importante lembrar que a caixa de texto é utilizada pelo programa apenas 
como uma referência para o posicionamento e alinhamento do texto, portanto não 
apresenta nenhum contorno. 


Caso você queira desenhar um retângulo em torno da caixa de texto, basta utili- 
zar a função pdf. rect, passando os parâmetros adequados. Faremos dessa forma no 
exemplo a seguir, nomeado como caixatexto. php, Serão criadas quatro caixas de texto, 
uma com cada tipo de alinhamento, e em torno delas será desenhado um retângulo 
para facilitar sua visualização. Como veremos mais adiante, existe um método cha- 
mado stroke, que deve ser utilizado sempre que formos desenhar algo na tela. 
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caixatexto.php 


<?php 
$p = new PDFHIDO; 
if C5p->begin document ("", "3 == 0) { 
die("Erro: " . Sp->get errnsg0); 
f; 
$p->begin_page_ext(595, 842, ""); 
$texto = "Estou escrevendo um texto dentro de uma caixa de texto! Que bacana!"; 
jopcoes = "fontnamesÁrial fontsize=38 encoding=winansi”; 


SobjTexto = $p->create textflow(ftexto,"Sopcoes alignment=left"); 
&p->fit textflow(SobjTexto, 50, 630, 545, 810, ""); 
fp->rect(50,630, 500, 180); 

$p->stroke(); 

Sp->delete textFlow(SobjTexto); 


SobjTexto = $p->create textflow(ftexto, "Sopcoes alignment=right"); 
4p->fit textflow(SobjTexto, 50, 430, 545, 610, ""); 

$p->rect(50, 430,500, 180); 

$p->stroke0; 

$p->delete_textflow{($objTexto); 


$objTexto = $p->create_textflow($texto, "$opcoes alignment=justify"); 
$p->fit_textflow($objTexto, 50, 230, 545, 410, ""); 

$p->rect(50,230, 500,180); 

Sp->stroke(); 

$p->delete textflow(fobjTexto); 


SobjTexto = $p->create textflow(ftexto, "fopcoes alignment=center"); 
4p->fit textflowCSobjTexto, 50, 30, 545, 210, ""); 

$p->rect(50, 30,500,180); 

$p->stroke(); 

$p->detete textflowCSobjTexto); 


Sp->end page ext(""); 
&p->set parameter ("openactian”, "fitpage"); 
$p->end document (""); 


$buf = $p->get buffer O; 

Slen = strlen(Sbuf); 

header("Content-type:applicatian/pdf"):; 

header ("Content-Length:$len"); 
header("Content-Disposition:inline; filename=caixatexto. pdf"); 
echo $buf; 

?> 


Ao executar esse programa no navegador, você irá obter um documento como 
o apresentado na figura 84. 
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Estou escrevendo um texto 
dentro de uma caixa de 
texto! Que bacana! 


Estou escrevendo um texto 
dentro de uma caixa de 
texto! Que bacana! 


Estou escrevendo um texto 
dentro de uma caixa de 
texto! Que bacana! 


Estou escrevendo urn texto 
dentro de uma caixa de 
texto! Que bacana! 


Figura 8.4 — Utilizando caixas de texto. 


Formatando o texto 


Veremos agora algumas maneiras de formatar textos em um documento PDF. Para 
isso, serão utilizados os métodos set parameter, set value €e setcolor para definir os 
atributos do texto. O método set. parameter serve para alterar o valor de algum parâ- 
metro de configuração. Vamos utilizá-lo neste tópico para alterar as configurações 
do texto. Sua sintaxe é a seguinte: 


bool set parameter (string chave, string valor) 


Parâmetro Descrição 
chave Nome da propriedade cujo valor será alterado. 
valor Novo valor para a propriedade especificada. 


Por exemplo, para escrever um texto sublinhado, teremos que executar antes O 
seguinte comando: 


Spdf->set parameter( “underline”, “true"); 


A documentação da PDFlib contém a lista completa dos parâmetros que podem 
ser alterados com o uso desse método. 
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O método set value tem a sintaxe parecida, sendo utilizado para configurar alguns 
parâmetros numéricos: 


bool set value (string chave, Float valor) 


Parâmetro Descrição 
chave Nome do parâmetro cujo valor será alterado. 
valor Novo valor (numérico) para o parâmetro especificado. 


Por exemplo, para escrever um texto somente com o contorno, teremos que exe- 
cutar antes o seguinte comando: 


$pdf->set value("textrendering", 1); 


O parâmetro textrendering pode ter seu valor variando de O a 7, cada um deles 
representando uma forma diferente de desenhar o texto. Os mais utilizados são o 
O (texto preenchido), o 1 (texto contornado) e o 2 (texto preenchido e contornado). 
Também podem ser configurados com essa função parâmetros como "“charspacing", 
"horizscaling", "wordspacing", "textrise”, entre outros. À documentação da PDFlib 
contém a lista completa desses parâmetros. 


O método setcolor serve para definir a cor de preenchimento e de contorno que 
será utilizada. Sua sintaxe é apresentada a seguir: 


bool setcolor (string tipo, string sistema cores, float cl, float c2, float c3, float c4) 


Parâmetro Descrição 


tipo Pode assumir os valores "fill" (preenchimento), "stroke" (contorno) 
ou "both" (ambos). 


sistema cores Indica o sistema de cores que será utilizado. Os valores possíveis 
são ray, rgb, cmyk, spot e pattern, 


ci Primeiro componente da cor para o sistema especificado por 
sistema cores. 

cZ Segundo componente da cor para o sistema especificado por 
sistema cores. 

c3 Terceiro componente da cor para o sistema especificado por 
sistema cores. 

c4 Quarto componente da cor para o sistema especificado por sistema. 
cores. 


Os componentes das cores são valores em ponto flutuante que variam de 0 a 1. 
Para o sistema rgb, são utilizados os parâmetros ci (red), c2 (green) e c3 (blue). Para o 
sistema gray, apenas o primeiro componente é utilizado. Por exemplo, para definir a 
cor de preenchimento como branco, teremos de executar o seguinte comando antes 
de escrever o texto: 


Spdf->setcolorC "fil", "rgb, 2, 1, 1, 0); 
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Em relação ao contorno do texto, além de definir sua cor com a função pdf. 
setcolor, você também pode aumentar ou reduzir sua espessura. Isso ocorre por 
meio da função pdf setlinewidth. Por exemplo: 


$pdf->setrlinewidth(2); 


Veremos agora um exemplo de programa PHP utilizando esses comandos de 
formatação de textos. Acompanhe o programa texto.php, que exibe seis linhas de 
texto, com uma formatação diferente para cada uma delas. 


Nesse exemplo, você verá que se utilizou um método chamado continue text. 
Esse método tem por objetivo escrever o texto na linha seguinte do documento, 
tomando como referência a última posição utilizada. Dessa forma, não precisaremos 
especificar as coordenadas a cada vez que um texto for escrito, como fazemos no 
caso do método show xy: 


texto. php 


<?php 

$p = new PDFTIDO; 

if ($p->begin documentQ"", ""} == 0) { 
die("Erro: " . &p->get.errmsg0); 

) 

$p->begin page ext(595, 842, "9; 

$font = $p->load font("Helvetica-Bold”", “winansi", O; 

&p->setfont(Sfont,32.0); 

f/ primeiro texto 

&p->set parameter ("overline”, “true"); 

Sp->show xy( "Linha sobre o texto”, 50, 780); 

$p->set parameter ("overline", "false"); 

/! segundo texto 

fp->set parameter(Punderline”, "true"); 

$p->continue text("Texto sublinhado"); 

Sp->set parameter("underline”,"false"); 

ff terceiro texto 

£p->set parameter("strikeout", "true'); 

&p->continue text("Texto tachado"); 

Sp->set parameter("strikeout”,"false'); 

{/ quarto texto 

4p->setcolor ("FINS "rgb", 0, 0, 1, 0); 

$p->continue text("Texto azul"); 

ff quinto texto 

Sp->set value("textrendering",1); 

Sp->setcolor('stroke","rgb", 1, 0, 0, 0); 

$p->continue text("Texto contornado em vermelho"); 

ff sexto texto 

&p->set value("textrendering",2); 

$p->setcolor("fi11", "rgb", 0, 0, 1, O; 

$p->setlinewidth(2); 
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Sp->continve text("Texto azul, contorno vermelho"): 


Sp->end page ext(""); 

$p->end document (""): 

Sbuf = $p->get buffer); 

$tamanho = strlen($buf); 

header("Content-type application/pdf"): 

header ("Content-Length: Stamanho"): 

header ("Content-Disposition: inline; filename=texto. pdf"); 
echo $buf; 

?> 


Observe as diferentes formatações aplicadas ao texto, acessando a página texto. 
php no navegador. O resultado é apresentado na figura 8.5. 


Linha sobre o texto 
Texto sublinhado 
Texto-tachadeo 


Texto azul . 
ido coniermado em vernmalho 
Texto azul, contorno vermelho 


Figura 8.5 — Formatação de textos. 


Inserindo imagens no documento 
Inserir uma imagem em um documento PDF requer a realização de dois passos: 
1, Carregar a imagem com o método load image. 


2. Inseri-la em uma determinada posição do documento com o método fit image. 
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O método load image possui a seguinte sintaxe: 


int load image (string tipo imagem, string nome arquivo [, string Tista opções]) 


Parâmetro 


Descrição 


tipo imagem 


nome arquivo 
lista opções 


Tipo da imagem que será aberta. Pode assumir os valores "jpeg", 
"ti ff", "gi fF" ou "png". 
Nome do arquivo da imagem. 


Opções a ser passadas ao método. Você pode passar uma string 
vazia (““) se não houver opções, 


Após executar essa função, a imagem estará aberta e você poderá inseri-la no 
documento quantas vezes quiser, podendo especificar seu posicionamento e tama- 
nho. Isso é feito por meio do método fit image, que possui a seguinte sintaxe: 


bool fit image (int imagem, float x, float y, string lista opções) 


Identificador da imagem, obtido no momento da abertura do ar- 


Parâmetro Descrição 
imagem 

quivo. 
x Coordenada x do ponto no qual a imagem será inserida. 
Y Coordenada y do ponto no qual a imagem será inserida. 
lista opções 


Opções a ser passadas ao método. Você pode passar uma string 


vazia (““) se não houver opções. 


Como exemplo, considere o programa imagens.php apresentado a seguir. Esse 
programa abre uma imagem JPEG chamada postgresgl.jpg e a exibe em cinco ta- 


manhos diferentes: 


imagens.php 


<?php 
$p = new POFTIbO ; 


if ($p->begin_document("", "") == 0) { 


die{"Erro: 


} 


. $p->geterrmsgO); 


$p->begin_page_ext{595, 842, ""); 
Sim = 3p->load inage ("jpeg", "postgresql. jpg", ""); 


if fim) { die("Erro: 
Sp->fit image(Sim, 
$p->fit_image($im, 
$p->fit_image{$im, 
$p->fit_image($im, 
$p->fit_image($im, 
$p->close_image (Sim); 
$p->end_page_ext(""); 
$p->end_document{""); 


"$p->get_errmsgO); } 
20, 500, "scale 1"); 
170, 500, "scale 0.75"); 
280, 500, "scale 0.50"); 
355, 500, "scale 0,25"); 
395, 500, "scale 0.10"); 


$buf = $p->get bufferQ; 
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$tamanho = strlen(Shuf); 

header ("Content-type: application/pdf; 

header ("Content-Length: Stamanho"); 
header("Content-Disposition:inline; filename=imagens.pdf"): 
echo fhuf; 

T> 


Veja que primeiro a imagem é exibida em seu tamanho original (escala 1). Logo 
após, utilizando uma opção chamada “scale” reduzimos para 75% do tamanho, 
depois 50%, 25% e, por fim, 10%. O resultado obtido ao executar o programa no 
navegador é apresentado na figura 8.6. 


PostgreSQL 


PostgreSQL 


navate 


Figura 8.6 — Inserindo imagens em um documento PDF. 


Desenhando em um documento 


Veremos agora como utilizar o PHP para desenhar em um documento PDF alguns 
elementos gráficos básicos, como linhas, curvas, quadrados, retângulos, círculos e 
arcos. Em todos os exemplos desse tópico, você verá que se usou o método stroke 
que, conforme comentado anteriormente, deve ser sempre utilizado quando formos 
desenhar algo na tela. Os elementos gráficos só serão desenhados na página após a 
execução desse método. Existe também o método fill. stroke, que além de desenhar 
os elementos gráficos no documento, preenche-os com a atual cor de fundo (fill). 


Capítulo 8 « A versatilidade dos documentos PDF 269 


Linhas e curvas 


Para desenhar linhas em um documento PDF, utilizamos o método Tineto, que traça 
uma linha do ponto corrente até um determinado ponto: 


bool tineto (float x, float y) 


Parâmetro Descrição 


x Coordenada x do ponto no qual a linha deve terminar. 
y Coordenada y do ponto no qual a linha deve terminar. 


O método que desenha curvas é o curveto, que, partindo do ponto corrente, 
desenha uma curva baseada nos três pontos fornecidos como parâmetros. Sua 
sintaxe é a seguinte: 


bool curveto (float x1, float yl, float x2, float y2, float x3, float y3) 


Parâmetro Descrição 


xi Coordenada x do primeiro ponto pelo qual a curva vai passar. 
yl Coordenada y do primeiro ponto pelo qual a curva vai passar. 
x2 Coordenada x do segundo ponto pelo qual a curva vai passar. 
y2 Coordenada y do segundo ponto pelo quał a curva vai passar. 
x3 Coordenada x do ponto final da curva. 
y3 Coordenada y do ponto final da curva. 


Vejamos, então, um exemplo envolvendo linhas e curvas. Acompanhe o progra- 
ma linhas.php apresentado a seguir. Esse programa desenha uma figura formada 
por duas linhas e uma curva. Essa figura é desenhada duas vezes, sendo uma sem 
preenchimento e outra com preenchimento na cor verde. 


linhas.php 
<?php 
$p = new PDETIDO; 
if CSp->begin document("", "") == 0) { 
dieC"Erro: " . Sp->geterrmsgO); 
} 


Sp->begin page ext(595, 842, "")}; 
!! desenha duas linhas e uma curva 
Sp->moveto(400,700); 
Sp->Tineto(200,750); 
Sp->lineto(400,800) ; 
$p->curveto(100,800, 100,750, 100,700}; 
Sp->stroke(): 
/f desenha a mesma figura, só que preenchida 
$p->setcolor("fi11", "rgb", 0, 1, 0, 0); 
£p->moveto(400,550); 
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$p->linetoć200, 600); 
$p->lineto(400,650); 
$p->curveto(100,650, 100,600, 100,550); 
ip->closepathO); 
Sp->fill stroke(); 
&p->end page ext(""): 
$p->end document (3: 
$buf = $p->get buffer(); 
$tamanho = strlenCSbuf); 
header ("Content -type: application/pdf"); 
header ("Content -Length: $tamanho"); 
header("Content-Disposition: inline; filename=linhas. pdf"): 
echo $buf; 
?> 


Note que quando a figura foi desenhada com preenchimento, antes de desenhá- 
la se utilizou o método closepath. Close path significa “fechar caminho”, ou seja, a 
finalidade é ligar o primeiro ao último ponto da figura. Observe na figura 87 o 
documento PDF obtido ao acessar o programa linhas. php no navegador. 


Figura 8.7 — Desenhando linhas e curvas. 
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Retângulos e quadrados 


O método que desenha retângulos ou quadrados é o rect, que recebe como parâ- 
metro o ponto inicial (inferior esquerdo) da figura e suas dimensões. Sua sintaxe 
é a seguinte: 


bool rect (float x, float y, float Targura, float altura) 


Parâmetro Descrição 

x Coordenada x do ponto inferior esquerdo do retângulo. 
y Coordenada y do ponto inferior esquerdo do retângulo. 
largura Largura (em pontos) do retângulo. 

altura Altura (em pontos) do retângulo. 


Para desenhar um quadrado, basta que os parâmetros largura e altura sejam iguais. 
Vejamos, então, um exemplo envolvendo retângulos e quadrados. Acompanhe o 
programa retangulos.php apresentado a seguir, Esse programa desenha um retângulo 
comum, um quadrado preenchido com amarelo e um retângulo pontilhado em 
torno dos dois. 


retangulos.php 


<?php 
$p = new PDFIib{); 
if ($p->begin document", ""} == 0) { 
die("Erro: " . $p->get.errmsgO); 
} 
$îp->begin_page_ext(595, 842, “O; 
ff retângulo 
$p->rect(70,650,200,100); 
$p->stroke(); 
/! quadrado preenchido 
$p->setcolor("fi11", "rgb", 1, 1, 0, 0); 
$p->rect(350,650,100,100); 
$p->fiN strokeO; 
/4 retângulo pontilhado 
$p->setcolor("stroke", "rgb", 0, 0, 1, 0); 
$p->setdash(4,6); 
$p->rect{40, 600,500,200); 
$p->stroke(): 
Ip->end. page ext(""); 
fp->end document (""3; 
Sbuf = Sp->get buffer(); 
ftamanho = strlen($buf); 
header ("Content-type:application/pdf"); 
header (“Content-Length: Stamanho"); 
header("Content-Disposition:intine; filename=retangulos. pdf"); 
echo $buf; 
T> 
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Para definir o último retângulo, utilizou-se o método setdash para definir o padrão 
de pontilhado (dash pattern). Observe na figura 88 o documento PDF obtido ao 
acessar O programa retangulos.php no navegador. 


Figura 8.8 — Desenhando retângulos e quadrados. 


Círculos e arcos 


Para desenhar círculos em um documento PDF, utilizamos o método circle. Sua 


sintaxe é a seguinte: 


bool circle (Float x, float y, float raio) 


Parâmetro Descrição 

x Coordenada x do ponto central do círculo. 
y Coordenada y do ponto central do círculo. 
raio Medida do raio do círculo. 


O método que desenha arcos é o arc, que desenha um arco no sentido anti-horário 
com base nos ângulos fornecidos como parâmetros. Sua sintaxe é a seguinte: 


bool arc (Float x, float y, float raio, float ang int, float ang fim) 
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Parâmetro Descrição 

x Coordenada x do ponto central do círculo cujo arco será desenhado. 
y Coordenada y do ponto central do círculo cujo arco será desenhado. 
raio Medida do raio do círculo. 

ang_ini Ângulo no qual o arco irá iniciar. 

ang fim Ângulo no qual o arco irá terminar. 


Vejamos, então, um exemplo envolvendo um círculo e um arco. Acompanhe o 
programa circulos.php apresentado a seguir. Esse programa desenha um círculo 
preenchido com verde e um arco, variando de 0º a 180º, preenchido com amarelo, 


Es circulos.php 
<?php 


$p = new POFTIDO; 
if (fp->begin. document ("", "") == 0) { 


die("Erro: " . &p->get errmsg()): 
) 
$p->begin page ext(595, 842, ""}; 

!f circulo 


$p->setcolor("f111", "rgb", 0, 0.8, 0, 0); 
$p->circle(150,700,100); 
$p->fiN stroke (); 
ff arco 
$p->setcolor CTN", "rgb", 2, 1, 0, 0); 
$p->arc(400,700,100,0,180): 
$p->closepathO; 
$p->Fil stroke; 
£p->end page ext("'9; 
$p->end document ("3 
$buf = $p->get buffer(); 
$tamanho = strlen(tbuf); 
header("Content-type:application/pdf'D; 
header ("Content-Length: $tamanho"): 
header ("Content -Disposition:inline; filename=circulos. pdf"); 
echo Sbuf; 
7> 


Embora não seja obrigatório, nesse exemplo também se utilizou o método clo- 
sepath apenas para fechar o contorno do arco. Observe na figura 89 o documento 
PDF obtido ao acessar o programa circulos.php no navegador. 
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Figura 8.9 — Desenhando círculos e arcos. 


Definindo um modelo (template) para as páginas 


Um modelo (ou template) consiste em um determinado conteúdo-padrão que 
normalmente é exibido em todas as páginas do documento. Seria como se você 
definisse, por exemplo, o cabeçalho e o rodapé em um documento do Word, e essas 
informações fossem replicadas cada vez que uma nova página fosse criada. 


É simples criar um modelo para um documento PDF utilizando o PHP Inicia- 
mos um modelo com o método begin template ext e o encerramos com end tenplate. 
Entre esses dois comandos, devemos inserir todos os elementos que farão parte do 
modelo, como textos, imagens, linhas etc. A sintaxe do método begin template ext é 
a seguinte: 


int begin template ext (Float largura, float altura, string lista opções) 


Parâmetro Descrição 

largura Largura (em pontos) do modelo. 

altura Largura (em pontos) do modelo. 

Vista opções Opções a ser passadas ao método. Se não houver, devemos passar 


uma string vazia, 
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Como exemplo, considere o programa modelo.php apresentado a seguir. Esse 
programa cria um modelo composto pelo texto “Exemplo de modelo PDF} duas 
imagens (uma em cada canto superior da página) e uma linha. 


modelo.php 


<?php 
$p = new PDFHib(); 
if ($p->begin_document("", "") == 0) { 
diel"Erro: " . $p->get_errmsg{}); 
} 
fi cria o modelo 
Sim = Sp->load image ("jpeg", “postgresgl. jpg", ""); 
Stemplate = $p->begin template ext (595,842,""); 
&p->save(); 
Sp->fit image(Sim, 4, 795, "scale 0.15"); 
Sp->Fit image($im, 565, 795, “scale 0,15"); 
Sp->moveto(D, 793): 
$p->Tineto(595,793): 
Sp->strokeQ); 
ffont = £p->load font("Times-Bold”,"winansi",""): 
$p->setfont(Sfont,30): 
$p->show xy("Exemplo de modelo PDF",130,810); 
$p->restore(); 
$p->end template(); 
Sp->close image (Sim); 
/! primeira página 
$p->begin page ext(595, 842, ""); 
$p->fit image(Stemplate, 0, O, ""); 
Sp->end page ext(""); 
£/ segunda página 
£p->begin page axt(595, 842, ""); 
$p->Fit image(ftemplate, 0, 0, “3; 
$p->end page ext(""): 
£p->end. document (""); 
$buf = $p->get buffer); 
$tamanho = strlen(Sbuf); 
Header ("Content-type:application/pdf"); 
Header ("Content-Length: $tamanho"); 
Header("Content-Dispasition: inline; filename=modelo. pdf"); 
echo $buf; 
T> 


Os métodos save € restore foram utilizadas apenas para salvar o estado atual dos 
gráficos da tela antes de inserir o modelo. Veja que, após criado o modelo, basta 
inserilo em cada uma das páginas como se fosse uma imagem, com o método 
fit image. Nesse exemplo, o documento resultante terá duas páginas sem conteúdo 
algum, visto que o objetivo era mostrar como criar um modelo. Observe na figura 
810 o documento PDF obrido ao acessar o programa modelo. php no navegador. 
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Figura 8.10 — Criando um modelo (template) em um documento PDF. 


Inserindo referências no documento 


Referências são bastante úteis, pois por meio delas podemos encontrar e acessar 
rapidamente qualquer parte do documento. Existem vários tipos de referências que 
podem apontar para locais dentro do próprio documento ou até para um site da 
web. Neste tópico, veremos três tipos: os bookmarks, as miniaturas (thumbnails) e 
os weblinks. 


Bookmarks 


São utilizados principalmente em conteúdos que necessitam de uma divisão em 
tópicos e subtópicos. Os bookmarks aparecem em uma estrutura de árvore localizada 
na janela à esquerda do documento PDF. A figura 81! mostra um exemplo. 
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Figura 8.11 — Bookmarks. 


Ao clicar um subtópico da árvore, a posição corrente do documento é movida 
diretamente para o subtópico escolhido. Para adicionar um bookmark a um docu- 
mento PDF utilizando o PHP, devemos executar o método create bookmark dentro da 
página desejada. À sintaxe é a seguinte: 


int create bookmark (string texto , string lista opções) 


Parâmetro Descrição 

texto Descrição do bookmark. É o texto que irá aparecer na janela à 
esquerda. 

lista opções Opções a ser passadas ao método. Se não houver opções, passe uma 


string vazia, 


Por exemplo, para adicionar um tópico chamado “Clubes” e um subtópico 
chamado “Grêmio” dentro de uma página do documento, deveríamos executar os 
seguintes comandos: 


$topico = $p->create. bookmark("Clubes", “º); 
$p->create bookmark("Grêmio", “parent ftopico"); 


Note que, na primeira chamada, o método não recebe opções. Já na segunda 
chamada, o segundo parâmetro é utilizado para indicar que “Grêmio” é um sub- 
tópico de “Clubes”, 


Miniaturas (thumbnails) 


As miniaturas (ou thumbnails) têm a mesma função dos bookmarks, mas em vez 
de textos, são exibidas imagens. Outra diferença é que nos bookmarks é mais fácil 
visualizar as divisões, visto que são exibidos em uma estrutura em árvore, enquanto 
as miniaturas são todas mostradas em sequência. O método add thumbnail é respon- 
sável por inserir miniaturas para referenciar partes de um documento. Sua sintaxe 
é bastante simples: 


bool add thumbnail (int imagem) 
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Parâmetro Descrição 


imagem Identificador de uma imagem previamente aberta. 


Por exemplo, imagine um documento PDF que exibe a cada página informa- 
ções sobre um clube de futebol diferente. Poderiam ser criadas miniaturas com os 
logotipos dos times, e quando o usuário clicasse sobre um logotipo, seria exibida 
diretamente a página com as informações do clube escolhido. Para fazer isso, na 
página de cada clube deveria ser inserida uma miniatura da seguinte forma: 

Sim = 3p->load image ("jpeg", "clube. jpg",""): 


$p->add thumbnail (Sim); 
tp->close inage(Sim); 


O “clube. jpg” deveria ser substituído pelo nome do arquivo do clube em questão. 
Ao final desse tópico, veremos um exemplo envolvendo miniaturas. 


Weblinks 


Inserir um weblink em um documento PDF consiste em definir uma área do docu- 
mento que, quando clicada, irá direcionar o usuário a um site da web. Os métodos 
responsáveis pela inserção de weblinks são o create action € o create anhotation, que 
possuem as seguintes sintaxes: 


int create action (string tipo, string lista opções) 


Parâmetro Descrição 

tipo Para inserção de links, o tipo deve ser URI. 

lista opções Lista de opções do método. Para inserção de links, usamos a opção 
url. 


bool create annotation (Float inf esg x, float inf esq y, float sup.dir x, float sup dir y, 
string tipo, string lista opções) 


Parâmetro Descrição 

inf.esg x Coordenada x do ponto onde a área do weblink deve iniciar (canto 
inferior esquerdo). 

inf esq.y Coordenada y do ponto onde a área do weblink deve iniciar (canto 
inferior esquerdo). 

sup dir x Coordenada x do ponto onde a área do weblink deve terminar 
(canto superior direito). 

sup dir y Coordenada y do ponto onde a área do weblink deve terminar 
(canto superior direito). 

tipo Para inserção de links, o tipo deve ser Link. 

lista opções Opções a ser passadas ao método. Para criação do link, usaremos 


a opção action. 
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Uma idéia interessante é criar um link em torno de uma imagem. Dessa forma, 
ao clicar sobre a imagem, o usuário será direcionado ao endereço especificado. Nesse 
caso, para definir a área do weblink, é necessário obter as dimensões da imagem 
com o método get value. Por exemplo, digitando o código a seguir dentro de uma 
página, estaremos inserindo um weblink em torno da imagem teste.jpg que irá 
direcionar o usuário para o site http://www. niederauer com.br: 


$im = $p->1oad image ("jpeg", “teste. jpg", "O; 

$p->fit image(fim, 250, 700, ""); 

Slargura = $p->get value ("inagewidth”, Sim); 

Saltura = $p->get value (“imageheight”, Sim); 

$url = $p->create_action( URI", "url=http: //waw.niederauer . com.br”); 

$p->create annotation (250, 700, 250+$largura, 700+$altura, "Link", "action {activate $ur1}"); 
$p->close_image($im); 


Programa-exemplo com referências 


Veremos agora um exemplo envolvendo os três tipos de referências apresentadas: 
bookmarks, miniaturas (thumbnails) e weblinks. Acompanhe o programa referencias. 
php, que cria um documento de duas páginas, e uma será usada para o clube “Grê- 
mio” e outra para o “Flamengo” Nesse documento são criados: 


" bookmarks com o tópico “Clubes” e subtópicos “Grêmio” e “Flamengo”; 


« miniaturas com os logotipos dos dois times obtidas dos arquivos gremio. jpg 
e flamengo. jpg; 


* weblinks criados em torno da imagem dos logotipos para o site oficial dos 
clubes. 


referencias.php 


<?php 
$p = new PDFIIDO; 
if €Sp->begin document ("", "") == 0) 1 
die("Erro: " . $p->get errmsg0); 
} 
$p->begin page ext(595, 842, ""); 
£j adiciona um thumbnail 
Sim = $p->19ad image {"jpeg", "gremio. jpg", ""); 
£p->add thumbnail (Sim); 
4! adiciona um bookmark 
ftopico = fp->create bookmark("Clubes", "O: 
fp->create bookmark("Grêmio", "parent $topico"); 
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ff adiciona um weblink 

$p->Fit image(Sis, 250, 700, ""); 

$largura = $p->get value ("imagewidth", tim); 

Saltura = $p->get value ("inageheight", Sim); 

$url = $p->create action("URI", "url=http://ww. gremio.net"); 

$p->create annotation (250, 700, 250+$largura, 700:faltura, "Link", "action {activate $ur1}"); 

$p->close_image{$im}; 

font = $p->load_font("Hetvetica-Bold","winansi", ""); 

$p->setfont{ $font, 20); 

$p->show_xy{ "Página sobre o Grêmio", 40, 800); 
$p->end_page_ext C"); 


&p->begin page ext(595, 842, ""): 
ží adiciona um thumbnail 
$im = $p->load image {"jpeg", "flamengo. jpg", ""); 
$p->add thumbnail (Sim); 
ff adiciona um weblink 
&p->fit image($im, 250, 700, ""); 
Flargura = $p->get value (“imagewidth", fim); 
Saltura = $p->get value ("imageheight", Sim); 
$url = $p->create action( URI", “url=http://ww. Flamengo, com.br"): 
$p->create annotation (250, 700, 250+$largura, 70%$altura, "Link", "action {activate $ur1}"): 
Sp->close image(Sin): 
ff adiciona um bookmark 
fp->create bookmark("Flamengo”, "parent $topico"); 
// conteúdo da página 
Sp->setfontCSfont, 20): 
3p->show xy("Página sobre o Flamengo", 40, 800); 
$p->end_page_ext(""); 
$p->end_document ("")}; 
$buf = $p->get_bufferO; 
$tamanho = strlen($buf}; 
header{"Content-type:application/pdf"); 
header ("Content-Length:$tamanho") ; 
header ("Content-Disposition:inline; filename=referencias. pdf"); 
echo $buf; 
?> 


Observe na figura 8.12 como ficaria a primeira página do documento. Veja 
também a lista das miniaturas na janela à esquerda. Ao clicar, por exemplo, sobre 
a miniatura do logotipo do Flamengo, a posição corrente passará direto para a 
página desse time. 


Na guia localizada à esquerda, você pode escolher se deseja visualizar os bookma- 
rks ou as miniaturas na janela. Em relação aos weblinks, ao clicar sobre as imagens do 
logotipo localizadas nas páginas de Grêmio e Flamengo, o usuário será direcionado 
ao site do clube escolhido. Isso ocorre porque definimos a região do weblink como 
sendo exatamente igual à região ocupada pela imagem no documento. 
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Figura 8.12 — Bookmarks, thumbnails e links em um documento PDF 


Exemplos de aplicações com a PDFlib 


Veremos agora dois exemplos de aplicações PHP que você pode criar utilizando as 
funções da PDFlib apresentadas no decorrer deste capítulo. 


Conversor TXT para PDF 


Uma aplicação bastante útil que pode ser criada com o PHP é um conversor do 
formato texto (txt) para o formato PDE Dessa forma, você poderia gerar rapida- 
mente documentos PDF para distribuir a seus usuários, oferecendo a eles todas as 
vantagens desse formato. 


Uma idéia interessante que iremos utilizar nesse exemplo é personalizar o do- 
cumento resultante usando um modelo (template) com o nome e o logotipo de seu 
site, que seria exibido em todas as páginas do documento. Se você não quiser utilizar 
um modelo, basta remover do programa o trecho de código que o cria. 


Vamos supor que o documento texto a ser convertido para o formato PDF está 
gravado em um arquivo chamado teste.txt. A figura 8.13 mostra um exemplo de 
como poderia ser esse arquivo. 
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Ei testetse-blocodenotas e 
à Arquivo Etar Ehematãe Esbit. Aida > 
FCONTRATO DO USUARIO 


O presente documanto descreve os Termos e Condições Gerais que são aplicáveis à uritização dos 
serviços disponibilizados pelo portal 5ó Matemática. se você não aceita estes Termos e Condições 
Gerais, deve abster-se de utilizar nossos serviços. Tendo alguma pergunta em relação aos mesmos, 
Jêntre em contato com O só Matemática. 


jo só Matemática se reserva o direito de modificar estes Termos e condições Gerais a qualquer 
momento, mediante simples aviso ao usuário através da colocação. nesta página, das modificações 
jaue forem realizadas. Os Termos e Condicões Gerais, ainda que modificados periodicamente, serão 
aplicáveis a todos os usuários cadastrados dasta site, a qualquer tempo. 


cadastramento como usuário dos serviços do Só Matemática é a utilização destes serviços 
goratuitos indicará a concordância com à presente documento e com os Termos e Condições descritos 
{PO documento Contrato do usuário. 


CLÁUSULA PRIMEIRA 


gtodos os serviços oferecidos pelo site só Matemática são Totalmente gratuitos permitindo que 
qualquer usuário, de gua tquer lugar do mundo, acesse & utilize os serviços do SÓ Matemática. para 
isto, basta que O usuário se cadastre. 


{CLAUSULA SEGUNDA 


JA partir da aceitação elerrônica deste Contrato e do prEenchimenta do cadastro, o usuário adquira 
o direito de usufruir Todos os serviços oferecidos pelo site, inteiramente grátis, 


LAUSULA TERCEIRA 


Jo usuário obterá acesso ao site Só Matemática 24 (vinte e quatro) horas por dia, 7 (sete) dias por 
Jsemana, salvo interrupções necessárias por ocasião de serviços de manutenção no sistema, quaisquer 
Jfalhas na operação das empresas fornecedoras de energia elétrica e/ou das empresas prestadoras de 

žl 


serviços de telecomunicação, casos fortuitos ou ações de terceiros. 


Figura 8.13 — Documento em formato texto. 


Esse arquivo contém o texto referente ao contrato do usuário de um site de 
matemática. Agora vamos criar um programa PHP para convertê-lo para o forma- 
to PDF Esse programa conversor será nomeado como txt2pdf.php. Será criado um 
modelo (template) contendo o logotipo e o nome do site, que será exibido no topo 
de cada página. 


Quanto ao texto do documento, será exibido com o uso de caixas de texto 
(ft textflou) já apresentadas neste capítulo, pois com estas temos o controle sobre os 
limites e o alinhamento do texto. Acompanhe, então, o programa txt2pdf .php e, logo 
após, as explicações sobre os principais trechos: 


txt2pdf.php 


<?php 
Sarquivo txt = "teste. txt": 
if (file exists(Sarquivo txt)) 
ftexto = file get contents (Sarquivo txt); 
else 
{ 
echo "Arquivo $arquivo_txt não encontrado!"; 
exit; 
} 
fmargem vertical = 60: 
Smargem horizontal = 40; 
$p = new PDFTIDO: 
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if (3p->begin. document ("", "") == 0) { 
dieC"Erro; " . $p->get errmsgO); 
k 
$p->set info("Creator”,"txt2pdf. php"); 
%p->set. info" Author", "Juliano Niederauer"); 
Sp->set info("Title", "Conversor TXT para PDF"); 
!! cria um modelo 
fim = $p->10ad image ("ipeg”, “matematica. jpg", ""); 
&nodelo = $p->begin template. ext(595,842,"); 
&p->save(); 
&p->fit image(Sim, 4, 791, ""); 
$p->moveto(0,789); 
4p->Tineto(595,789); 
4p->stroke O; 
Sfont = $p->load_font{"Times-Botd","winansi", ""}; 
£p->setfont (Sfont, 20); 
$p->show xy("Só Matemática - www. somatematica.com.br”,115,810); 
Sp->restore(); 
ip->end tenplateQ); 
$p->close image (Sim); 
4! cria a caixa de texto e insere o texto dividido em páginas 
tobjTexto = 3p->create textFlow(Stexto, "fontname=Arial fontsize=12 encoding=winansi 
alignment=justify"); 
do 
{ 
Sp->begin page ext(595, 842, ""); 
$p->fit. image(Smodelo, 0, 0, ""); // modelo 
$result = Sp->fit texrflowCSobjTexto, margem horizontal, Smargem vertical, 
595-fmargem horizontal, 842-$margem vertical, ""); 
$p->end page ext(" O; 
y} while ($result != " stop"); 
$p->set_parameter("openaction", "fitpage"}); 
$p->end document (""); 
$buf = $p->get..bufferQO; 
ftamanho = strlen(Sbuf); 
header ("Content-type: application/pdf; 
header ("Content -Length: Stamanho”); 
header ("Content-Disposition:inline; filename=txt2pdf. pdf"); 
echo Sbuf; 
?> 


Ao executar esse programa no navegador, será gerado o documento resultante 
no formato PDF, como mostra a figura 8.14. 
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Life unia O iai 


S6 Matemática - www. somatematica.com.br 


CONTRATO DO USUÁRIO 


O presente documento descreve os Termos e Condições Gerais que são aplicáveis à utilização 
das serviços disponibilizados pelo portal Sô Matemática. Se você não aceita estes Termos é 
Condições Gerais, deve abster-se de ulilizar nossos serviços. Tendo alguma pergunta em 
relação aog mesmos, entre em contato com o Só Matemática. 


O Så Matemática se reserva o díteilo de modificar estes Termos e Condições Gerais a qualquer 
momento, mediante simples aviso ao usuário através da colocação, nesta página, das 
modificações que forem realizadas. Os Termos e Condições Gerais, ainda que modificados 
pertadicamente, serão aplicáveis a todos os usuários cadastrados deste site, a qualquer tempo. 


O cadastramento como usuário dos serviços do Só Matemática e a utilização destes serviços 
gratuitos indicará a concordância com o presente documento e com es Termos e Condições 
descritos no documento Contrato do usuário. 


CLÁUSULA PRIMEIRA 


Todos ns serviços oferecidos pelo site Só Matemática são totalmente gratuitos permitindo que 
qualquer usuário, de qualeprer lugar do mundo, acesse e utilize os serviços do Sá Matemática. 
Para isto, basta que o usuário se cadastre. 


CLÁUSULA SEGUNDA 


A partir da aceitação eletrônica deste Conirato e do preenchimento do cadastro, o usuário 
adquire o direito de usufruir tados os serviços oferecidos pelo site, inteiramente grátis. 


Figura 8.14 — Documento resultante em formato PDF. 


Vamos analisar agora os principais trechos do programa. Primeiramente é testada 
a existência do arquivo ixt especificado. Se o arquivo não for encontrado, a execução 
será interrompida: 


if (file exists(farquivo txt)) 


Em seguida são definidas as margens vertical e horizontal, ou seja, as distâncias 
do texto em relação às bordas da página. Esses valores ajudam a definir a região da 
caixa de texto, e você pode alterá-los como desejar: 


fmargem vertical = 60; 
Snargem horizontal = 40; 
Logo após, o documento PDF é criado, assim como fizemos em todos os exemplos 


deste capítulo, e um modelo é defimido (entre begin template ext e end template). Se você 
não quiser utilizar um modelo, poderá excluir esse trecho de código. 


Começa, então, a parte principal do programa que consiste em um laço com 
o comando do.. .uhile, onde a cada iteração é criada uma página no documento. 
Antes, criamos o objeto de fluxo de texto e definimos suas propriedades, incluindo 


a fonte e o alinhamento: 


SobjTexto = $p->create textflow(Stexto,"Fontname=Arial Ffontsize-12 encoding=winansi 
alignment=justify"); 
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Dentro do laço de criação das páginas, primeiramente inserimos o modelo 
(template) criado no início do programa. Se você não quiser usar um modelo, re- 
mova essa linha: 


$p->fit image(fmodelo, 0, 0, "J; 


Em seguida, a exibição do texto na caixa é feita pelo método fit. textlow, que recebe 
como parâmetro nosso objeto de fluxo de texto e os limites da caixa: 


$result = $p->fit textflowCSobjTexto, fmargem horizontal, margem vertical, 
595-$margem horizontal, 842-$margem vertical, ""); 


O laço será repetido enquanto o valor da variável $result for diferente de "stop", 
pois esse valor indica que todo o texto do objeto já foi processado. 


Por fim, o documento é encerrado e enviado ao programa navegador, assim como 
fizemos nos demais exemplos deste capítulo. 


Relatórios PDF a partir de consultas SQL 


Essa é uma aplicação extremamente útil que pode ser criada com o PHP. O objetivo 
é fazer uma consulta SQL (Structured Query Language) a um banco de dados e 
gerar imediatamente um documento PDF com os registros resultantes, em forma 
de tabela. Essa aplicação pode ser usada para criar catálogos, listas de preços, re- 
latórios ou qualquer outro documento que seja gerado com base em um conjunto 
de registros retornados por uma consulta SQL. 


O programa que será apresentado neste tópico gera uma lista de preços baseada 
em uma consulta feita a um banco de dados MySQL. Para isso, será criada uma 
tabela no MySQL chamada tivros, que irá conter as informações sobre as obras 
vendidas pela Novatec Editora. Essa tabela será criada da seguinte forma no utili- 
tário mysql: 


create table livros 


( 
isbn varchar(13), 
titulo varchar(80) NOT NULL, 
autor varchar(80) NOT NULL, 
paginas smallint NOT NULL, 
preco float NOT NULL 

J 


Esse código de criação da tabela, assim como o código para a inclusão de alguns 
registros para fins de testes, está disponível no site da Novatec Editora em um arquivo 
chamado create.sql, no endereço indicado no início deste livro. 
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Veja a seguir alguns exemplos de inserção de registros: 


insert into livros values ('8575220128', "PostgreSQL - Guia de Consulta Rápida", 
“Juliano Niederauer ', 128, 20); 

insert into livros values ('8575220136', 'Aprendendo Delphi 6 & Kylix", 
'Fabrício Alex Simões", 320, 42); 

insert into livros values ('8575220098', "Python - Guia de Consulta Rápida", 
"Marco Catunda", 128, 20); 

insert into livros values ('8585184949', "Samba - Guia de Consulta Rápida!, 
'Décio Jr.', 128, 20); 

insert into livros values ('8585184809', 'Perl - Guia de Consulta Rápida, 
'Décio Jr.', 128, 20); 


Com as informações armazenadas por essa tabela, existe uma grande variedade 
de relatórios que poderíamos gerar, como, por exemplo: 


«livros em ordem alfabética; 
* livros ordenados por preço; 
* livros ordenados por ISBN; 
a livros por autor; 

= livros por assunto. 


Enfim, o relatório será gerado de acordo com a consulta SQL que fornecermos. 
Nesse exemplo, vamos utilizar a primeira opção, que consiste em obter a lista de todos 
os livros por ordem alfabética. Portanto, o comando SQL que utilizaremos será: 


SELECT * FROM Tivros ORDER BY titulo 


Você pode alterar à vontade o comando SQL que gera o relatório, assim como 
os demais parâmetros de configuração existentes no início do programa. Nesses 
parâmetros, você irá definir o nome das colunas que serão retornadas, assim como 
a largura destas. Acompanhe, então, o programa gera relatorio. php e, logo a seguir, 
as explicações. Neste exemplo, utilizaremos a extensão MySQLi para conexão com 
o banco de dados: 


gera relatorio.php 


<?php 

ff eetiiciime CONFIGURAÇÕES DO PROGRAMA titataarr 
/! documento 

Slargura = 842; 

Saltura = 595; 

inargem vertical = 30; 

Smargem horizontal = 30; 


Capítulo 8 = A versatilidade dos documentos PDF 287 


Stamanho fonte = 14; 

Staranho fonte titulo = 20; 

$ritulo = "Lista de Preços da Novatec Editora”; 

ff banco de dados 

$servidor = "localhost"; 

fusuario = "juliano"; 

$senha = "teste"; 

Shbanco = "test"; 

/! consulta SQL que irá gerar o relatório 

$consulta = "SELECT * FROM livros ORDER BY titulo”; 

Scolunas resultantes = array (isbn", "titulo", "autor", "preco"); 
/! tabela a ser gerada no PDF 

texto colunas = array ("ISBN", “Título”, "Autor", "Preço"); 
Slargura coluna = array (90, 360, 280, 150); 


J/ terrre NÃO ALTERE DAQUI EM DIANTE **+tHrt+* 


/f executa a consulta 

tcon = miysqli connect (Sservidor, Susuario, $senha, Sbanco); 
$result = mysgli query(fcon, consulta); 

Stotal = mysqli num rows(Sresutt); 

if ($total==0) 


{i 
nysqh close(fcon); 
echo "O relatório não foi gerado porque a consulta não retornou registros!"; 
exit; 

} 


ff cria o documento PDF 
$p = new PDFIIbDO; 
if ($p->begin. document ("", "") == 0) £ 
die("Erro: " . $p->get errmsg0); 
} 
+! cálculos 
Saltura celula = ftamanho fonte+3; 
Saltura titulo = $ftamanho fonte titulo+3; 
altura tabela = Saltura - 2*margem vertical; 
Ji tirar 2 devido ao cabeçalho 
$Vinhas. por. pagina = intval (Cfaltura tabela-faltura titulo) /faltura celula)-d; 
$num paginas = ceil(ftotal/$linhas por pagina): 
$linha atual = 0; 
// gera as páginas 
for (Si = 0; $i < Snum paginas; $i++) 
{ 
!f cria nova página 
$p->begin page ext(flargura, Saltura,""3; 
ff tátulo do relatório 
font = $p->1oad font("Times-Bold","winansi", O; 
$p->setfont(Sfont, Stamanho fonte titulo); 
Sposy = Saltura - margem vertical; 
Sposx = $Smargem horizontal; 
$pag atual = $i+1; 
%p->show xy( $titulo." (página $pag. atual)”, $posx, Sposy); 
/! cria o cabeçalho da tabela em negrito 
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ffont = $p->load font("Times-Bold", "winansi",""); 
Sp->setfont($font, Stamanho fonte): 
$posy -= Saltura titulo; 
$posx = margem horizontal; 
$p->moveto($posx, $posy-3); 
&p->Tineto(Stargura-margem horizontal, fposy-3); 
$p->stroke(); 
for ($k = 0; $k < sizeof(Stexto colunas); $k++) 
{ 
$p->show_xy($texto_colunas[$k], tposx, $posy}; 
fposx += $largura_coluna[$k]; 
J 
f! tira o negrito da fonte 
$font = $p->load font("Times-Roman", "winansi",""y; 
Sp->setfont(Sfont, Stamanho fonte); 
ff escreve os registros 
Sinicio = Slinha atual; 
$fim = Slinha atual + $linhas por pagina; 
if CSfim > Stotal) 
$fim = Stotal; 
for (3j = Sinicio; $j < $fim; $jm) 
{ 
Elinha atual = $j; 
$posx = $margem horizontal: 
$posy -= Saltura celula: 
Sdados = mysqli fetch array(Sresult); 
for $k = 0; $k < sizeof(fcolunas resultantes): $k++) 
f 
valor = $dados[fcolunas, resultantes[$k]]; 
Sp->show xyCSvalor, Sposx, $posy): 
$posx += $largura coluna[$k]; 
k 
Elinha atual; 
} 
/f encerra a página 
$p->end page ext(""); 
} 
mys4li_close{$con); 
f! encerra o documento PDF 
3p->set parameter("openaction”, "fitpage"); 
&p->end document (""); 
$buf = $p->get bufferO); 
Stamanho = strien($buf); 
header ("Content-type:application/pdf"); 
header ("Content-Length: Stamanho"); 
header("Content-Disposition:inline; filename=relatorio. pdf"); 
echo $buf; 
7> 


Observe, na figura 815, o documento PDF gerado por esse programa. Os regis- 
tros resultantes aparecem em forma de tabela, e cada coluna possui a largura que 
definimos no início do programa. 
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Lista de Preços da Novatec Editora (página 1) 


ISBN 

8575220136 
8575120017 
8383194582 
8575220187 
8575210473 
gI8SLSA7S2 
$575220357 
$573220314 
E385 184779 
8571220063 
83583134H X 
8575220054 
BSESIBAIOS 
8585184132 
BABSLS4STA 
BS8S18461Z 
8585 18199x 
8585184450 
8585184329 
8585184566 
858514531 
3533184930 
8575220268 
6585134663 
8585134654 
B37512049 
8573220039 
B385EB4333 
8575220776 


Tito 


Aprendendo Delphi 6 & Kylix 

Aprendendo Java 2 

ARJ - Guis de Consulta Rápida 

As Palavras Mais Comuns da Lingua Ingtesn 

As palmas mais commas da Lingua Inglesa - 3! edit Eo 
ASP - Guia de Consulta Rápida 

ASP NET com CH 

ASP NET Gina da Desenvolvedor 

Autocad 2000 - Guia de Consulta Rápida 

BASH - Guia de Consulta Rápida 

CH - Guia de Consulta Rapida 

Cascading Style Sheets (C99) - Gura de Consulta Rápida 
Clipper 3.2 - Guia de Consulta Rápida 

Clipper Mensagens de Erro - Guia de Consulta Rápida 
Cobol ANS 8% - Guia de Consulta Rápida 

Cobol Sem Misterne 

ColdFusion - Guta de Consulta Rápida 

Construindo Apliestrros com o Visual Basic d 

Corel Draw 5 - Guia de Consulta Rápida 

CorelDraw 7 Fonts - Guia de Consulta Rapida 
CorelDraw Symbols - Cha de Consulta Rápida 
Crystal Reports - Guia de Consulta Rápida 

DE? UDB v.7 - Guia de Consulta Rápida 


Delphi 4 Funções e Procedimentos - Guia de Conmlta Rápida 


Delphi 4 Object Pascal - Guia de Consulta Rapida 
Desenvolvendo Aplicações ASP NET com Web Matrix 
Desenvolvendo Websites com PHP 4 

Dreamweaver - Guia de Cousulta Rápida 

Editor Vi - Guia de Consulta Rápida 


Autor 

Fabricio Alex Simões 
Rodrigo Mello Ramon Chiara Renato Villela 
Robens Prates, Joel Sande 
Robens Queiroz de Almeida 
Rubens Queiroz de Almeida 
Rubens Prates 

Alfredo Lotar 

Felipe Cembrameli 

Leonardo Lemes 

Joal Sande 

Mana Rezende 

Luis Gustavo Amaral 

Rubens Prates 

Rubens Prates 

Joel Sande 

Joel Sande 

Eloi Assis 

Marcelo Moya Dias 

Rubens Prates, Adruma Pedra 
Horie 

Horie 

Joel Sande 

Joño Alberto de Olivera Lana 
Rutens Prates 

Rubeus Prates 

Daniel Wander 

Jlis Niederauer 

Marcelo Silveira 

Roberto Severo de A Coelho 


Figura 8.15 — Documento PDF gerado a partir de uma consulta SOL. 


Conforme indicado no código do programa, as variáveis de configuração termi- 
nam onde há o comentário 


ff eee NÃO ALTERE DAQUI EM DIANTE satsaxixa 


Antes desse comentário, estão todas as variáveis que você pode modificar de 


acordo com suas necessidades. A seguir será apresentada uma descrição de cada 


uma delas: 


Variável 


$largura e $altura 


Descrição 


Dimensões das páginas do documento PDF Note que nesse 


programa invertemos as medidas que vínhamos utilizando 
(842 x 595 em vez de 595 x 842). Isso foi feito porque para 
um relatório é mais adequado utilizar o formato horizontal 
(paisagem ou landscape). 


fmargem vertical e $margem horizontal 


$tamanho fonte 


$tamanho fonte titulo 


Distância do texto da tabela até as bordas da página. 


mento. 


do relatório. 


Tamanho, em pontos, da fonte que será utilizada no docu- 


Tamanho, em pontos, da fonte que será utilizada no título 
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Variável Descrição (cont.) 
$tituło Título do relatório, que irá aparecer no topo de todas as 
páginas. 


$servidor, $usuario, $senha e $banco 


Defina nessas variáveis a configuração de seu banco de 


dados. 
$consulta Consulta SQL a partir da qual o relatório será gerado. 


$colunas_resultantes Array contendo os nomes das colunas da tabela que farão 
parte do resultado, Os nomes devem ser exatamente iguais 
aos nomes dos campos da tabela, pois serão utilizados para 
acessar os campos do conjunto de registros resultantes. 


ftexto. colunas Array contendo os textos que serão exibidos para as colu- 
nas no documento PDF. O objetivo é exibir um texto mais 
amigável ao usuário para identificar a coluna. Por exemplo, 
em um campo que armazena uma data de nascimento seria 
mais amigável exibir “Data Nasc” Em vez de “dtnasc” Esse 
array deve ter o mesmo número de elementos que o array 
anterior, o $colunas resultantes. 


$largura coluna Array contendo a largura (em pontos) de cada uma das 
colunas no documento PDF Esse array deve ter o mesmo 
número de elementos que o fcolunas. resultantes. Você pode 
modificá-lo até adaptá-lo ao tamanho das colunas que sua 
consulta irá retornar. 


Após a definição das variáveis de configuração, é aberta uma conexão com o ban- 
co de dados MySQL e executada a consulta que definimos na variável Sconsulta: 


icon = mysqli connect(Sservidor, Susuario, $senha, $banco); 
$result = mysqli query(Scon, $consulta); 


Caso a consulta não retorne registros, a conexão com o banco de dados será fe- 
chada e a execução do programa será encerrada com o comando exit. Caso contrário, 
a execução prosseguirá com a criação do documento PDF e os cálculos necessários 
para o desenho da tabela. 


Deixaremos três pontos de distância entre cada linha da tabela e também três 
pontos entre o título e o início dessa tabela: 


faltura celula = ftamanho fonte + 3; 
$altura titulo = $tamanho fonte titulo + 3; 


Quanto à altura da tabela, basta subtrair da altura do documento a medida da 
margem vertical multiplicada por 2 (superior e inferior): 


Saltura tabela = $altura - 2*jmargem vertical; 
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Precisamos também calcular quantas linhas serão exibidas em cada página, para 
posteriormente definir quantas páginas o documento terá. Para obter o número de 
linhas, dividimos a altura da tabela pela altura de cada célula. Não podemos esque- 
cer-nos de descontar a altura do título, que está embutida na altura da tabela: 


$linhas por pagina = intval ((faltura tabela-Saltura titulo)/Saltura celula) - 1; 


O “-1” foi acrescentado ao final para que não seja contabilizada a primeira linha, 
que diz respeito ao nome das colunas, ou seja, o cabeçalho da tabela. De posse do 
número de linhas, podemos definir o número de páginas dividindo o número total 
de registros pelo número de linhas por página. A função ceil serve para arredondar 
esse resultado para baixo: 


$num paginas = ceil(Stotal/flinhas por pagina); 


Em seguida, inicia o laço principal do programa com o comando for, onde para 
cada página serão executados os seguintes passos: 


1. É escrito o título do documento com o número da página atual, obtido a 
partir da variável de controle do laço: 


jpag atual = $i + 1; 
$p->show xy(Stitulo.” (página fpag atual)", $posx, tposy); 


2. É selecionada a fonte em negrito para escrever os títulos das colunas, ou seja, 
o cabeçalho da tabela: 


Sfont = $p->load font("Times-Bold”,“winansi”,""); 


3. É criado um laço com o comando for para escrever os nomes das colunas 
baseados nos arrays que definimos no início do programa ($texto colunas € 


flargura coluna): 

for ($k = 0; $k < sizeof(ftexto colunas); $k++) 

{ 
&p->show xy(Stexto colunas[$k], $posx, $posy); 
$posx += Slargura coluna[$k]; 

k 


4. São calculadas as posições de início e fim dos registros, ou seja, estamos de- 
finindo qual o intervalo de registros que fará parte da página atual. Para isso, 
utilizamos o número de linhas por páginas calculado anteriormente. Caso a 
página atual seja a última, possivelmente o valor final calculado será maior 
do que o total de registros e, nesse caso, deverá ser ajustado: 
ginicio = Slinha atual; 
$fim = $linha atual + Slinhas por. pagina; 


if ($fim > ftotal) 
Sfim = $total; 
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5. Mais dois laços são criados com o comando for, um para percorrer os registros 
eo outro para escrever os quatro campos de cada um deles no documento. Os 
campos acessados serão aqueles que definimos no início do programa no array 
$colunas. resultantes. À cada campo escrito, a coordenada x será incrementada 
com base na largura que definimos para cada coluna: 


fdados = mysqli fetch.arrayCSresult); 
for ($k = 0; $k < sizeof(Scolunas resultantes): $k++) 


{ 
$valor = fdados[$colunas_resultantes[$k]]; 
fp->show xy(Svalor, $posx, $posy}; 
$posx += $largura_coluna[$k]; 

} 


Por fim, o documento é encerrado e enviado ao programa navegador, assim como 
fizemos nos demais exemplos deste capítulo. 


Exemplos utilizando a FPDF 


A PDFlib é uma excelente biblioteca para a geração de documentos PDF, porém 
não é a única. Veremos neste tópico alguns exemplos utilizando a FPDF, disponível 
gratuitamente em http://wmm. fpdf.org. A FPDF surgiu como alternativa em relação 
à PDFlib. Sua vantagem é que está disponível em forma de uma classe PHE Dessa 
forma, não é necessário que você tenha qualquer extensão instalada e configurada. 
Basta colocar os arquivos da classe em seu servidor e inserir uma chamada para 
ela no início de seus programas. 


Assim como na PDFlib, na FPDF as funções são chamadas como métodos em 
uma classe, ou seja, com os caracteres “>” A seguir é apresentado no programa 
exemplo. fpdf.php o exemplo mais simples que pode ser criado com a FPDF. Esse 
programa apenas cria um documento, adiciona uma página a este e escreve o texto 
"Kello World". 


Os arquivos da classe FPDF foram copiados para o diretório fpdf, localizado no 
mesmo diretório do programa: 
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exemplo. fpdf.php 


<?php 

define! FPDF FONTPATH",'fpdf/font/'): 
require once("fpdf/fpdf. php"); 
Spdf=new FPDF(); 

$pdf->0pen O); 

$pdf->AddPage O) ; 
Spdf->SetFontC' Arial! ,'B',36); 
%pdf->Ce11€50,30, Hello World!'); 
Spdf->0utput); 

?> 


A primeira linha define o diretório onde estão localizadas as fontes, e a segun- 
da torna a classe FPDF disponível ao programa. O objetivo desse tópico é apenas 
mostrar que existem bibliotecas alternativas para a geração de documentos PDF, 
por isso não iremos nos aprofundar nos comandos dessa classe. O manual com a 
descrição de cada comando da FPDF está disponível no site http: //wm. fpdf .org. 


Vejamos agora um outro exemplo envolvendo seleção de fontes, caixas de texto, 
linhas, uso das cores e definição de alinhamentos. Acompanhe o programa apre- 
sentado a seguir, nomeado como exemplo? fpdf. php, para entender como funcionam 
esses recursos de formatação da FPDF: 


exemplo? fpdfphp 


<?php 

define('FPDF_FONTPATH"' ,'fpdf/font/'); 
require once("fpdf/fpdf. php"); 

Spdf=new FPDFO; 

Spdf->Open(); 

Spdf->addPage O ; 

$pdf->5etXY(10, 20); 

4pdf->SetFont(' Helvetica", '8', 20): 
Spdf->Cell(75, 5, 'Esta é a classe FPDF'); 
Spdf->SetFont('Helvetica", 'I', 14); 
$pdf->Ce11(0, 5, '{(http://www. fpdf.org) OD; 
$pdf->1nO; 

$pdf->SetLinewidth(0.5); 

$pdf->Line(10, 27, 200, 27); 

4pdf->In(5): 

$pdf->SetFont('Courier', 'B', 10); 
$pdf->SetLinewidth(0.2); 
Spdf->MultiCel(O, 5, "O comando MultiCel] nos permite escrever dentro de uma caixa de 


texto e utilizar quebras de linha.\nA quebra de Tinha pode ser automática ou forçada com 
o caractere nº, 1, 1); 


SpdF->In(5); 
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$pdf->SetFiliColor (153, 153, 153); 

$pdf->SetTextColor(255, 255, 255); 

&pdf->MultiCell(O, 10, "Esta é uma caixa de texto com preenchimento em cinza e texto 
escrito em branco. O alinhamento do texto é o justificado.", 1, 9', 1, 1); 

$pdf->SetTextColor(0, 0, 0); 

&pdf->In(5); 


$pdf->SetFont('Helvetica", '', 10); 

Spdf->Celi(O, 5, 'Alguns tipos de fontes: ', O, É); 
Spdf->SetFontC'Courier', 'B', 12); 

$pdf->Cell(0, 5, 'Texto em Courier 12 em negrito", 0, 1); 
$pdf->SetFont(' Helvetica", '', 10); 

$pdf->Ce11(0, 5, 'Texto em Helvetica 10", O, 1); 
Spdf->SetFontQ'Arial', "BI", 14); 

Spdf->Cell(0, 5, 'Texto em Arial 14 em negrito e itálico!, 0, 1); 
Spdf->In(5); 

Spdf->SetFontC'Helvetica', "', 10); 

Spdf->Cel1 (60, 5, “Escrevendo textos com cores”, O, 0); 
Spdf->SetTextColor(255, O, 0); 

$pdf->Celt(30, 5, “Vermelho”, 0, 0); 
Spdf->SetTextColor(o, 255, 0); 

Spdf->CeliG0, 5, "Verde", 0, 0); 

$pdf->SetTextColor(O, 0, 255); 

Spdf->Celi(G0, 5, "Azul", 0, 0); 

&pdf->SetTextColor(O, 0, 0); 

Spdf->InC5); 

$pdf->Celi(o, 5, 'É possível definir o alinhamento dos textos em uma célula:", O, 1); 
&pdf->Celi(O, 5, 'Alinhamento à esquerda", 1, 1, 'L'3; 
Spdf->Celi(O, 5, "Alinhamento centralizado', 1, 1, 'C9; 
Spdf->Cell(0, 5, "Alinhamento à dirita’, 1, 1, 'R'); 
4pdf->0utput O; 

?> 


Os principais métodos utilizados nesse programa foram: 


Método Descrição 

Cell Para escrever um texto em uma célula (área retangular). 
Line Para traçar uma linha. 

In Para inserir quebras de linha. 

SetFont Para alterar a fonte corrente, 

SetTextColor Para definir a cor do texto. 

Multicell Para criar caixas de texto. 


À sintaxe e a descrição completa de cada um desses métodos estão no manual 
da classe FPDF Ao executar esse programa no navegador, será gerado o documento 
PDF resultante, como mostra a figura 816. 
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Esta é a classe FPDF (http:/mmw.ipoforg) 


DL 
: comando MultiCell nos permite eocrever dentro de uma caixa de texto o utilizar quebras 


de linha. 


A quebra de linha pode vor automática ou forçada com o caracter im 


Alguns tipos de fontes 

Texto em Courier 12 em negrito 

Texto em Helvetica 10 

Texto em Arial 14 em negrito e itálico 


Escrevendo textos com cores Vermelho 
É possivel definir o alinhamento dos textos em uma eéiuta: 
[Alinhamento à esquerda 


Alinhamento centralizado 


Alinhamento à direita 


Figura 8.16 — Exemplo utilizando a classe FPDF. 


Funções do PHP para manipulação de documentos PDF 


Além das principais funções que vimos neste capítulo, existem outras da biblioteca 
PDFlib que nos permitem criar e manipular documentos PDF com a linguagem PHP. 
A seguir, serão apresentadas as funções que podemos utilizar e a descrição de cada 
uma delas. Não estão listadas as funções que já se tornaram obsoletas. Conforme 
explicado neste capítulo, na versão 5 do PHP essas funções devem ser chamadas 
como métodos do objeto PDFlib, enquanto no PHP 4 a sintaxe permanece orien- 


tada a funções. 


pdf activate item 
Ativa um elemento de estrutura ou outro item de conteúdo. 


bool pdf activate item (recurso documento pdf, int id item) 


pdf add nameddest 
Cria um destino nomeado. 


bool pdf add nameddest (recurso documento pdf, string nome, string Nista opções) 
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pdf add table cell 
Adiciona uma célula a uma tabela nova ou já existente. 


int pdf add. table cell (recurso documento pdf, int tabela, int coluna, int Tinha, 
string texto, int lista opções) 


pdf add textflow 


Cria um objeto de fluxo de texto ou adiciona um texto a um objeto já 
existente. 


int pdf_add_textflow (recurso documento pdf, int objetotexto, string texto, string Tista opções) 


pdf add thumbnail 


Adiciona à página corrente uma miniatura (thumbnail), que irá aparecer no 
painel de miniaturas exibido à esquerda do documento. 


int pdf add thumbnail (recurso documento pdf, int imagem) 


pdf arc 


Desenha um arco em sentido anti-horário. Lembre-se de utilizar a função 
pdf stroke para desenhar o objeto. 


void pdf.arc (recurso documento pdf, float x, float y, float raio, float angl, Float ang?) 


pdf aren 


Desenha um arco em sentido horário. Lembre-se de utilizar a função pdf. stroke 
para desenhar o objeto. 


void pdf aren (recurso documento pdf, float x, float y, float raio, float angl, float ang2) 


pdf hegin document 
Cria um novo arquivo PDF. 


int PDF begin document (recurso documento pdf, string nome arquivo, string lista opções) 


pdf begin font 
Inicia uma definição de fonte Tipo 3, 
bcol pdf begin font (recurso documento pdf, string nome arquivo, Float a, float b, 
float c, float d, float e, float f, string lista opções) 
pdf begin glyph 
Inicia uma definição glyph para uma fonte Tipo 3. 


bool pdf begin glyph (recurso documento pdf, string nome givph, float wx, float 
inf esq x, float infesyy, float sup dir x, float sup dir y) 
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pdf begin item 
Abre um elemento da estrutura ou outro item de conteúdo. 


int pdf begin item (recurso documento pdf, string tag, string lista opções) 


pdf begin layer 
Inicia uma camada. 


bool pdf begin layer (recurso documento pdf, int camada) 


pdf begin page ext 
Inicia uma nova página. 
bool pdf begin page ext (recurso documento pdf, Float largura, float altura, string 
lista opções) 
pdf begin pattern 


Inicia a definição de um novo padrão (pattern), que poderá ser utilizado para o 
preenchimento de objetos. Retorna o identificador do padrão criado, que será 
utilizado pela função pdf setcolor para associá-lo a um determinado objeto. 


int pdf begin pattern (recurso documento pdf, float largura, Float altura, 
float passo x, float passo y, int tipo pintura) 
pdf begin template ext 


Inicia a definição de um novo modelo (template). O modelo criado pode 
ser tratado como uma imagem, sendo inserido no documento pela função 
pdf fit image. 


int pdf begin template ext (recurso documento pdf, float largura, float altura, 
string lista opções) 
pdf circe 


Desenha um círculo. Lembre-se de utilizar a função pdf. stroke para desenhar 
o objeto. 


void pdf-circle (recurso documento. pdf, Float x, float y, float raio) 


pdf clip 
Seleciona o caminho atual, definindo-o como clip path. Normalmente 
utilizado em torno de figuras irregulares. 


void pdf.clip (recurso documento. pdf) 


pdf close image 
Fecha a imagem associada com o identificador fornecido como parâmetro. 


void pdf close image (recurso documento pdf, int imagem) 
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pdf dose pdi page 
Fecha uma página aberta com a função pdf open pdi. page. 


void pdf close pdi page (recurso documento pdf, int id página) 


pdf closepath fill stroke 


Completa o caminho corrente (adicionando uma linha do último ao primeiro 
ponto), preenchendo-o e desenhando-o no documento. 


void pdf closepath. fill stroke (recurso documento pdf) 


pdf closepath stroke 


Completa o caminho corrente (adicionando uma linha do último ao primeiro 
ponto) e o desenha no documento. 


void pdf closepath stroke (recurso documento pdf) 


pdf closepath 


Completa o caminho corrente adicionando uma linha do último ao primeiro 
ponto. 


void pdf closepath (recurso documento. pdf) 


pdf concat 
Concatena uma matriz à atual matriz utilizada para transformação de textos 
e gráficos (CTM). 
void pdf concat (recurso documento pdf, float a, float b, float c, float d, float e, 
Float f) 
pdf continue text 


Escreve um texto na linha seguinte do documento. Normalmente é utilizada 
após a função pdf show xy para escrever um texto logo abaixo do último texto 
exibido. 


void pdf continue text (recurso documento pdf, string texto) 


pf create action 
Cria ações para objetos ou eventos. 


int pdf create action (recurso documento pdf, string tipo, string lista opções) 


pof create annotation 
Cria anotações retangulares. 


bool pdf. create amnotation (recurso documento pdf, Float inf esg x, float inf esq, 
float sup dir x, float sup dir y, string tipo, string lista opções) 
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pdf create bookmark 
Cria um bookmark na página corrente. 


int pdf create bookmark (recurso documento pdf, string texto, string lista opções) 


pdf create field 
Cria um campo de formulário, 
bool pdf create field (recurso documento pdf, float inf_esq_x, float infiesqy, 
float sup dir x, float sup dir.y, string nome, string tipo, string lista opções) 
pif create fieldgroup 
Cria um grupo de campos em um formulário. 


bool pdf create fieldgroup (recurso documento pdf, string nome, string lista opções) 


pdf create gstate 
Cria o estado gráfico de um objeto. 


int pdf create gstate (recurso documento pdf, string Tista opções) 


pdf create pyf 
Cria um arquivo virtual PDFlib, 


bool pdf create pvf (recurso documento. pdf, string nome arquivo, string dados, 
string lista opções) 


pdf create textflow 
Cria um objeto de fluxo de texto. 


int pdf create textflow (recurso documento pdf, string texto, string lista opções) 


pdf curveto 


Desenha uma curva Bezier a partir do ponto corrente, utilizando outros três 
pontos de controle. 


void pdf curveto (recurso documento pdf, float x1, float y1, float x2, float y2, 
float x3, float y3) 


pdf define layer 
Cria a definição de uma camada (layer). 


int pdf define layer (recurso documento pdf, string nome, string lista opções) 


pdf delete pvf 
Exclui um arquivo virtual PDFlib. 


int pdf delete pyf (recurso documento. pdf, string nome arquivo) 
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pof delete textflow 
Exclui um objeto de fluxo de texto. 


bool pdf detete textflow (recurso documento pdf. int Fluxo texto) 


pdf delete 
Exclui um objeto PDF e libera todos os recursos associados a ele. 


void pdf delete (recurso documento. pdf) 


pdf encoding set char 
Adiciona um nome glyph e/ou um valor Unicode ao documento. 


bool pdf encoding set char (recurso documento pdf, string codificação, int slot, 
string nome glyph, int uv) 


pdf end document 
Fecha um arquivo PDF. 


bool pdf end document (recurso documento pdf, string lista opções) 


pdf end font 
Encerra uma definição de fonte Tipo 3. 


bool pdf end font (recurso documento pdf) 


pdf end glyph 
Encerra uma definição glyph para fontes Tipo 3. 


bool pdf end glyph (recurso documento pdf) 


pdf end item 
Fecha o elemento de estrutura ou item de conteúdo especificado. 


bool pdf end item (recurso documento pdf, int id item) 


pdf end layer 
Desativa todas as camadas ativas. 


bool pdf end layer (recurso documento. pdf) 


pdf end page ext 
Encerra uma página. 


bool pdf end page ext (recurso documento pdf, string lista opções) 
pdf end page 


Encerra uma página do documento iniciada pela função pdf begin page. 


void pdf end page (recurso documento pdf) 
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pdf end pattem 
Encerra a definição de um padrão iniciada pela função pdf. begin. pattern. 


void pdf end pattern (recurso documento pdf) 


pdf end template 


Encerra a definição de um modelo (template) iniciada pela função pdf. begin. 
template. 


void pdf end template (recurso documento pdf) 


pdf endpath 
Encerra o caminho corrente. 


bool pdf endpath (recurso documento pdf) 


pdf fill imageblock 
Preenche um bloco de imagem com dados variáveis. 


int pdf Fill imageblock (recurso documento pdf, int página, string bloco, int imagem, 
string Fista opções) 


pof fill pdfblock 
Preenche um bloco PDF com dados variáveis. 


int pdf f411 pdfblock (recurso documento. pdf, int página, string bloco, int conteúdo, 
string lista opções) 


pdf fill stroke 


Preenche o caminho atual e o desenha no documento. Para desenhá-lo sem 
preenchimento, utilize a função pdf. stroke. 


void pdf. fill stroke (recurso documento pdf) 


pdf fill textblock 
Preenche um bloco de texto com dados variáveis. 


int pdf fill textblock (recurso documento. pdf, int página, string bloco, string texto, 
string Tista opções) 


pdf fill 


Preenche o caminho atual. Essa função apenas preenche o caminho, não 
definindo nenhum contorno para ele. 


void pdf Fill (recurso documento pdf) 
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pdf fit image 
Posiciona uma imagem ou template. 
bool pdf fit image (recurso documento pdf, int imagem, float x, float y, 
string lista opções) 
pdf fit poi page 
Insere uma página PDF importada. 


bool pdf fit pdi page (recurso documento pdf, int página, float x, float y, 
string lista opções) 


pdf fit textflow 
Formata um fluxo de texto em uma área retangular. 


string pdf. fit textflow (recurso documento pdf, int fluxo texto, float inf_esq_X, 
float infesq y, float supdir x, float sup dir y, string lista opções) 


pdf fit textline 
Posiciona uma linha simples de texto. 
bool pdf fit textline (recurso documento pdf, string texto, float x, float y, 
string lista opções) 
pdf get apiname 
Obtém o nome de uma função API. 


string pdf get apiname (recurso documento pdf) 


pdf get buffer 


Obtém o conteúdo do buffer onde estão localizados os dados referentes ao 
documento PDF gerado. 


string pdf.get buffer (recurso documento. pdf) 


pdf get errmsg 
Retorna a mensagem referente ao erro ocorrido. 


string pdf get. errmsg (recurso documento pdf) 


pdf get ermum 
Retorna o número referente ao erro ocorrido. 


int pdf get.errnum (recurso documento. pdf) 


pdf get parameter 


Obtém o valor de um determinado parâmetro do documento. A lista dos 
parâmetros disponíveis deve ser consultada na documentação da PDFlib. 


string pdf get parameter (recurso documento pdf, string chave [, float modi ficador]) 
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pdf get value 


Obtém o valor de um determinado parâmetro numérico do documento. À 
lista dos parâmetros disponíveis deve ser consultada na documentação da 
PDFlib, 


float pdf get value (recurso documento pdf, string chave [, float modi Ficador]) 


pdf info font 
Retorna informações detalhadas sobre uma fonte carregada. 


float pdf.info font (recurso documento. pf, int fonte, string palavra chave, 
string Tista opções) 


pdf info matchbox 
Consulta informações de uma matchbox. 


float pdf info matchbox (recurso documento. pdf, string nome box, int num, 
string palavra chave) 


pdf info tahle 
Retorna informações sobre uma tabela. 


float pdf info table (recurso documento pdf, int tabela, string palavra chave) 


pdf info textftow 
Retorna o estado de um objeto de fluxo de texto. 


float pdf info textflou (recurso documento. pof, int objeto texto, string palavra chave) 


pdf info textline 
Realiza formatação de linhas de texto. 
float pdf.info textline (recurso documento. pdf, string texto, string palavra chave, 
string Jista opções) 
pdf. initgraphics 
Reinicia todos os parâmetros gráficos e de cores, fazendo-os assumir seus 
valores-padrão. 


void pdf initgraphics (recurso documento pdf) 


pdf lineto 


Desenha uma linha do ponto corrente até o ponto (x,y) especificado. Você 
pode especificar o ponto corrente utilizando a função pdf moveto. 


void pdf Vineto (recurso documento pdf, float x, Float y) 
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pdf load 3ddata 
Carrega um modelo 3D do disco ou de um arquivo virtual, 


int pdf. load Jddata (recurso documento pdf, string arquivo, string Tista opções) 


pdf load font 
Busca e prepara uma fonte para uso. 
int pdf load font (recurso documento pdf, string fonte, string codificação, 
string lista opções) 
pdf load iccprofile 


Busca e prepara um perfil de cores ICC (International Color Consortium) 
para uso. 


int pdf. load iccprofile (recurso documento pdf, string perfil, string lista opções) 


pdf load image 
Abre um arquivo de imagem, 
int pdf load image (recurso documento pdf, string tipo imagem, string nome arquivo, 
string lista opções) 
pdf makespotcolor 


Define a cor atual como sendo uma cor especial chamada spot e a associa a 
um determinado nome, 


void pof makespotcolor (recurso documento. pdf, string mome spot) 


pdf. moveto 


Define o ponto corrente. Normalmente utilizada antes de funções como 
pdf. Vineto e pdf show. 


void pdf moveto (recurso documento. pdf, float x, float y) 


pdf new 


Cria um novo objeto PDF. Realiza o gerenciamento de memória e utiliza o 
gerenciador de erros-padrão. 


int pdf new { ) 


pdf open pdi page 
Abre uma página no documento PDI especificado. 


int pdf open poi page (recurso documento pdf, int id doc, int página, string label página) 
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pdf pcos get number 
Obtém o valor do caminho pCOS com o tipo number ou boolean. 


float pdf. pcos get number (recurso documento. pdf, int doc, string caminho) 


pdf pros get stream 
Obtém o conteúdo do caminho pCOS com o tipo stream, fstream ou string. 
string pdf. pcos get stream (recurso documento pdf, int doc, string lista opções, 
string caminho) 
pdf pcos get string 
Obtém o valor do caminho pCOS com o tipo name, string ou boolean. 


float pdf pcos get string (recurso documento pdf, int doc, string caminho) 


pdf process pdi 
Processa um documento PDF importado. 


int pdf process pdi (recurso documento pdf, int doc, int página, string lista opções) 


pdf rect 


Desenha um retângulo com o canto inferior esquerdo localizado nas 
coordenadas x e y especificadas e com as dimensões definidas pelos 
parâmetros largura e altura. 


void pdf_rect (recurso documento pdf, float x, float y, float largura, float altura) 


pdf restore 
Restaura o último estado dos gráficos salvos pela função pdf save. 


void pdf restore (recurso documento. pdf) 


pdf resume page 
Reinicia uma página. 


bool pdf resume page (recurso documento pof, string Tista opções) 


pdf rotate 


Realiza uma rotação no sistema de coordenadas de acordo com o ângulo 
fornecido. 


void pdf rotate (recurso documento. pdf, float ângulo) 


pdf save 


Salva o estado gráfico corrente do documento. O estado gráfico inclui o sistema 
de coordenadas, ponto corrente, estilo de linhas, parâmetros de cores etc. 


void pdf save (recurso documento pdf) 
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pdf scale 


Define a escala do sistema de coordenadas. Além de afetar as coordenadas x 
e y também afeta medidas como altura, largura, espessura da linha e raio. 


void pdf scale (recurso documento pdf, float escala x, float escala y) 


pdf set gstate 
Ativa o estado gráfico do objeto. 


bool pdf set gstate (recurso documento. pdf, int estado grafico) 
pdf set info 


Define os campos de informação sobre um documento, que serão exibidos 
P Ç q 
quando o usuário visualizar suas propriedades. Os campos que podem ser 
definidos são “Subject” (assunto), “Title” (título), “Creator” (criador), “Author” 
J A 
(autor), “Keywords” (palavras-chave) ou outra chave definida pelo usuário. 
Y P P 


void pdf_set_info (recurso documento pdf, string chave, string valor) 


pdf set layer dependency 
Define o relacionamento entre as camadas do documento. 


bool pdf set layer. dependency (recurso documento pdf, string tipo, string lista opções) 


pdf set parameter 


Altera o valor de um determinado parâmetro do documento (exs.: underline, 


overline, strikeout, openaction etc). A lista completa dos parâmetros deve ser 
consultada na documentação da PDFlib. 


void pdf. set parameter (recurso documento pdf, string chave, string valor) 
pdf set text pos 


Define a posição corrente para inserir textos no documento. Um texto pode 
ser escrito com a função pdf. show. 


void pdf set text pos (recurso documento pdf, float x, float y) 


pdf set value 


Altera o valor de um determinado parâmetro numérico do documento (exs.: 
charspacing, horizscaling, leading, textrendering etc). A lista completa dos 
parâmetros disponíveis deve ser consultada na documentação da PDFlib. 


void pdf set value (recurso documento pdf, string chave, float valor) 
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pdf setcolor 


Define a cor de preenchimento ou de contorno. O número de componentes 
que irão formar a cor pode variar de 1 a 4, dependendo do sistema de cores 
utilizado, que pode ser gray, rgb, cmyk, spot ou pattern. O tipo pode ser “fl” 
(preenchimento), “stroke” (contorno) ou “both” (ambos). 


void pdf .setcolor (recurso documento pdf, string tipo, string sistema cores, float ct 
[, float c2 [, float c3 [, float c4)])) 


pdf_setdash 


Define o padrão de pontilhado de acordo com as unidades de preto e branco 
fornecidas. 


void pdf setdash (recurso documento pdf, float preto, float branco) 


pdf setdashpattern 
Define o padrão de pontilhado. 


bool pdf setdashpattern (recurso documento pdf, string Vista opções) 


pdf setflat 


Define a distância máxima (flatness) entre o caminho de um objeto e uma 
aproximação criada com linhas. Pode assumir um valor entre O e 100. 


void pdf setflat (recurso documento pdf, float valor) 


pdf setfont 


Define a fonte corrente, assim como seu tamanho. Recebe como parâmetro o 
identificador da fonte retornado previamente pela função pdf. findfont. 


void pdf setfont (recurso documento pdf, int fonte, float tamanho) 


pdf setlinecap 


Altera o valor do parâmetro linecap, que faz que a linha seja desenhada de 
forma diferente (ex.: com os cantos arredondados). Pode assumir um valor 
entre O e 2. 


void pdf. setlinecap (recurso documento pdf, int valor) 


pof setlinejoin 


Configura o tipo de junção entre duas linhas. Pode assumir um valor entre 
Dez 


void pdf setlinejoin (recurso documento pdf, int valor) 
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pdf setlinewidth 
Define a espessura da linha que será utilizada para desenhar as figuras. 


void pdf setlinewidth (recurso documento pdf, float espessura) 


pdf setmatrix 


Define a matriz corrente para transformações. Essa função nos oferece um modo 
de utilizar, em um nível mais baixo, as mesmas funcionalidades de funções 
como pdf scale, pdf rotate e pdf translate para produzir transformações. 


void pdf setmatrix (recurso documento pdf, float a, float b, float c, float d, float e, 
float f) 


pdf setmiterlimit 


Configura o limite miter para um valor maior que ou igual a 1. Esse é um 
limite que pode ser configurado quando for definida uma junção entre linhas 
do tipo miter, por meio da função pdf. setlinejoin. 


void pdf setmiterlimit (recurso documento pdf, float valor) 


pdf shading pattern 
Define o padrão de sombreado. 


int pdf shading pattern (recurso documento pdf, int sombreamento, string lista opções) 


pdf shading 
Define uma mistura da cor corrente de preenchimento com outra cor. 


int pdf.shading (recurso documento pdf, string tipo sombra, float x0, float yọ, 
float x1, float y1, float ci, float c2, float c3, float c4, string Tista opções) 


pdf shfil 
Preenche uma área com sombreamento. 


bool pdf shfill (recurso documento pdf, int sombreamento) 


pdf show xy 
Escreve um texto em um determinado ponto do documento utilizando a 
fonte corrente. 


void pdf show xy (recurso documento pdf, string texto, float x, float y) 


pdf show 


Escreve um texto no ponto corrente do documento utilizando a fonte corrente, 
A posição em que o texto será escrito pode ser definida anteriormente com 
a função pdf set text. pos. 


void pdf show (recurso documento pdf, string texto) 
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pof skew 


Inclina o sistema de coordenadas do documento nos eixos x e y de acordo 
com os ângulos fornecidos. 


void pdf skew (recurso documento pdf, float ângulol, float ângulo?) 


pdf stringwidih 


Retorna a largura de um texto utilizando uma determinada fonte. Leva 
em consideração as alterações feitas com a função pdf. set. value, como, por 
exemplo, o espaçamento entre caracteres. 


Float pdf stringwidth (recurso documento. pdf, string texto [, int fonte [, float tamanho]]) 


pdf stroke 


Desenha uma linha em torno do caminho corrente. A espessura da linha pode 
ser definida pela função pdf .setlinewidth. 


void pdf stroke (recurso documento. pdf) 


pdf suspend page 
Suspende uma página. 


bool pdf suspend page (recurso documento pdf, string lista opções) 


pdf translate 


Define a origem do sistema de coordenadas. O canto inferior esquerdo do 
documento equivale ao ponto (00). Essa função pode mover essa origem para 
qualquer ponto da página 
void pdf translate (recurso documento pdf, float tx, float ty) 
pdf utfig to utfê 
Converte uma string de UTF-16 para UTF-8. 
string pdf utfl6 to utf8 (recurso documento pdf, string string utfi6) 
pdf utf32 to utfl6 
Converte uma string de UTF-32 para UTF-l6. 
string pdf utf32 to utfl6 (recurso documento pdf, string string utf3z, string ordem) 
pof utfê to utfl6 
Converte uma string de UTF-8 para UTF-16. 


string pdf utf& to utfl6 (recurso documento. pdf, string string utfê, string ordem) 


Capítulo 9 


Utilizando modelos: seja “Smarty” 


Neste capítulo, você irá entender a utilidade das ferramentas de modelos (template 
engines) disponíveis para o PHP além de aprender a programar com uma das mais 
utilizadas chamada Smarty (http: //smarty. php.net}, que será abordada com detalhes ao 
longo do capítulo. Serão apresentadas informações sobre a instalação, sintaxe, vari- 
áveis, funções e diversos exemplos para facilitar a compreensão dessa ferramenta. 


Por que utilizar modelos (templates)? 


De forma resumida, o objetivo dos modelos (templates) é separar a lógica do 
programa da lógica de exibição. Isso não consiste em separar o código HTML do 
código PHP, mas sim em colocar em lugares separados os códigos responsáveis pela 
exibição e os códigos responsáveis por outras tarefas, como, por exemplo, o acesso 
e obtenção de informações de um banco de dados. 


Portanto, o objetivo é criar scripts PHP independentes do layout que será utilizado 
para exibir o conteúdo da página. Fazendo essa separação, estaremos facilitando 
tanto a compreensão como a manutenção do código de nossos programas. 


Vamos utilizar como exemplo uma empresa chamada Pancho Villa Web Solu- 
tions, que desenvolve e presta manutenção de websites. Agora imagine que você 
foi contratado para trabalhar como programador PHP nessa empresa. Lembre-se 
de que sua função é a de programador PHP, e não de designer, o que significa que 
a estrutura visual, ou seja, o layout da página não será criado por você. E isso é 
bastante comum, visto que na maioria das empresas não é a mesma pessoa que faz 
o layout e a programação. 


Como programador, você irá receber do designer a página HTML pronta e terá 
de incluir a programação PHP que irá fazer que essa página se torne dinâmica. 
Porém, provavelmente essa página ainda vai voltar muitas vezes para as mãos do 
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designer, para que ele faça as alterações necessárias no layout. Você acha que seria 
adequado entregar a ele uma página repleta de código PHP? Com certeza não seria 
o ideal por duas razões: 


1. normalmente o designer não entende nada de PHP, o que faria que ele ficasse 
bastante confuso ao manipular uma página repleta de programação; 


2. ele poderia alterar ou até excluir alguma parte de seu código sem perceber, 
prejudicando o funcionamento da página. 


Você é programador, ele é designer. Vocês têm diferenças técnicas. O PHP não 
interessa a ele, e o HTML não interessa a você. Então, qual é a solução? Mandar o 
designer fazer um curso para aprender PHP? Não, nesse caso o ideal seria ter um 
bom sistema de templates. Para o designer é mais fácil lidar com os elementos de 
um sistema de templates do que com um código de programação PHP. E para você 
também seria melhor, pois seus programas ficariam mais “limpos” e fáceis de en- 
tender, pois não haveria código HTML no meio. 


As ferramentas existentes 


Qualquer método que separe a lógica do programa da lógica de exibição pode ser 
considerado um modelo ou template. Muitas pessoas criam sistemas “caseiros” 
de templates para uso em projetos menores. Porém, não há necessidade de perder 
tempo criando sua própria ferramenta de templates, a não ser que você queira 
aprender como se cria uma. Já existem diversas ferramentas prontas no mercado, 
como, por exemplo: Smarty Fast Template, Power Template, Xtemplate, ecTemplate 
e Atemplate. 


Tais ferramentas oferecem a funcionalidade de substituição básica de variáveis 
e permitem criar blocos dinâmicos nos modelos. Neste capítulo, será apresentada a 
ferramenta Smarty, pois possui algumas vantagens em relação às demais. A Smarty 
possui arquivos de configuração, funções para templates, modificadores de variáveis 
e oferece muitas facilidades para programadores e designers. Você pode usar Smarty 
tanto em projetos pequenos quanto em projetos maiores que necessitem de um bom 
gerenciamento de templates para separar layout e programação. 


Smarty — À ferramenta de modelos 


Veremos agora o que é Smarty, onde obter essa ferramenta, como funciona, qual é sua 
sintaxe básica e quais são as funções disponíveis para utilizarmos nos templates. 
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O que é Smarty? 


É uma ferramenta de modelos (template engine) para o PHP, Como se citou no 
tópico anterior, a Smarty tem algumas vantagens em relação às demais ferramentas 
do mercado, o que a torna mais smart (esperta). Seu funcionamento consiste em 
fazer uma espécie de compilação, convertendo os templates para scripts PHP. 


Se você não utilizasse templates, normalmente teria uma única página PHP 
contendo programação e HTML juntas. Utilizando templates, você teria duas 
páginas: 


* página PHP com a programação; 


= página do template contendo o layout. Esse será o arquivo usado pelo designer. 
Normalmente utilizamos a extensão .tpl para esse tipo de arquivo. 


Portanto, sem templates teriamos uma página do tipo: 


teste.php 
<html> 
<body> 
<?php 


7> 
</body> 
</html> 


Figura 9.1 — Programação sem templates. 


Já utilizando uma ferramenta de templates como a Smarty teríamos dois arquivos, 
sendo um com a programação PHP e outro com o layout (HTML) e os elementos 
da Smarty (variáveis, funções etc). Utilizando esses dois arquivos, a Smarty irá gerar 
o arquivo final, que mistura HTML e PHP A figura 92 ilustra esse processo. 


Como programador, você será o responsável pela página teste.php. O designer 
será responsável pela página teste.tpl. À Smarty será responsável por avaliar essas 
duas páginas e gerar o script final. 


Você deve estar se perguntando: qual é o impacto que essa compilação pode 
causar em termos de desempenho? Cada vez que alguém acessar a página, haverá 
uma nova compilação? Não, a vantagem da Smarty é que armazena os scripts que 
já foram compilados e reutiliza-os a cada acesso. Seria como utilizar uma memória 
cache para agilizar a execução. Muitas ferramentas de templates não funcionam dessa 
forma, o que prejudica bastante o desempenho da aplicação, visto que a tradução 
dos elementos do template deve ser feita toda vez que a página for acessada. 
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teste php 


teste.tpl.php 


>. 
</body> 
</html> 


teste.tpl 


<html> 
<body> 


{5marty} 


</body> 
</html> 


Figura 9.2 — Programação com a ferramenta Smary. 


Muitos desenvolvedores web reclamam da perda de desempenho de suas apli- 
cações em razão do uso de ferramentas de templates. A Smarty tenta reduzir essa 
perda exatamente por esse processo de reutilizar os scripts já compilados. Por essa 
razão, a diferença de velocidade muitas vezes nem é percebida, principalmente 
quando as páginas envolvidas não são muito complexas. 


Portanto, você tem duas opções: 


1. Ter um código mais confuso e atingir o máximo de desempenho em suas 
aplicações; 


2. Melhorar a compreensão e manutenção de seu código, apesar de perder um 
pouco em desempenho. 


Se sua opção for pela alternativa 2, seja “Smarty” e use templates! 
Pg P ) Y P 


Download e instalação 


Para executar a Smarty, é necessário que sua versão do PHP seja 40.6 ou superior. 
Você pode fazer o download da Smarty assim como sua documentação, no site: 


http://smarty.php.net/ 


Nesse site está disponível para download um arquivo compactado contendo 
todos os arquivos da ferramenta. Fazendo a descompactação, você verá que os ar- 
quivos da classe estão em um subdiretório chamado 1ibs. Coloque esses arquivos 
em um lugar adequado em seu servidor web. Preste atenção no local onde você irá 
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colocá-los, pois no início de seus programas deverá ser incluída uma chamada para 
a classe Smarty. 


Esses arquivos são sempre acessados por meio de seus programas e nunca dire- 
tamente pelo navegador. Por essa razão, por questões de segurança, é recomendável 
que você coloque-os fora da raiz do servidor web (document root). Dessa forma, 
ninguém conseguirá acessá-los com uma chamada direta por meio do navegador. 


Incluindo uma chamada para a classe 


Se você armazenar, por exemplo, os arquivos em um diretório chamado 1ibs, con- 
siderando que o programa PHP se encontra no mesmo local desse diretório, deve- 
remos executar as seguintes linhas no início do programa para criar uma instância 
da classe Smarty: 


require("Tibs/Smarty.class. php"); 
$smarty = new Smarty; 


A Smarty permite o uso de uma constante chamada SMARTY. DIR, que armazena o ca- 
minho do sistema dos arquivos da biblioteca. No entanto, não é obrigatório o uso dessa 
constante. Existem três maneiras de ativar a biblioteca em seus programas PHP: 


1. Fornecendo diretamente o caminho para o arquivo. Por exemplo: 


requireC' /usr/local/Tib/php/Smarty/Smarty.class.php'); 
$smarty = new Smarty; 


2. Adicionando o diretório da classe na diretiva include. path em seu arquivo de 
configuração php. ini e, logo após, reiniciando o servidor. Nesse caso, bastaria 
passar o nome da classe como parâmetro: 


require(' Smarty.class.php'); 
ismarty = new Smarty; 


3. Definindo o valor da constante SMARTY. DIR antes de incluir a chamada para a 
classe. Por exemplo: 


define('SMARTY DIR','/usr/local/Vib/php/Smarty/'): 


require(SMARTY DIR. 'Smarty.class.php'); 
$smarty = new Smarty; 


Estrutura da aplicação 


Para utilizar uma aplicação Smarty é necessária a criação de alguns diretórios. A 
Smarty requer quatro diretórios que, por padrão, são nomeados como: 
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Diretório Descrição 


templates Armazena os arquivos dos templates (modelos). 


templates c Diretório que armazena os templates compilados. Deve possuir per- 
missão de escrita. 


configs Armazena arquivos de configuração, se houver. 


cache Armazena os arquivos de cache e não precisa ser criado caso essa fun- 
cionalidade esteja desabilitada. Deve possuir permissão de escrita. 


Os nomes desses diretórios estão definidos nas propriedades da classe, nas variá- 
veis $template dir, $compile dir, $config dir e $cache dir. É recomendável a criação desses 
diretórios separadamente para cada aplicação Smarty que você desenvolver. 


Por exemplo, se tivéssemos uma aplicação Smarty que apresenta a lista de pro- 
dutos de uma empresa, e a raiz do servidor web fosse o diretório /web, poderíamos 
ter uma estrutura semelhante a essa: 


fweb/produtos/templates/ 
fweb/produtos/templates/produtos. tp] 
fweb/produtos/templates c/ 
fweb/produtos/configs/ 
fweb/produtos/cache/ 
fweb/produtos/produtos . php 


Veja que são necessários apenas dois arquivos, o restante são diretórios que 
serão utilizados pela Smarty. O arquivo produtos. tpl seria o arquivo do template, ou 
seja, aquele que define o layout da página, enquanto o arquivo produtos.php seria O 
programa PHP responsável por obter as informações sobre os produtos. 


É comum também nomear o programa principal como index.php, para simplificar 
o acesso pelo navegador. Por exemplo, se o arquivo produtos .php fosse renomeado para 
index. php, em vez de digitar no navegador: 


http://www. seudominio.com. br/produtos/produtos. php 
bastaria digitar: 


http://wem. seudominio.com.br/produtos 


Isso porque normalmente os servidores web que suportam PHP são configurados 
para utilizar a página index.php como sendo a página incial de um diretório, 


Você pode estar se perguntando: “por que o /web não faz parte desse endereço”? 
Não confunda o diretório raiz do sistema operacional com o diretório raiz do 
servidor web. Nesse caso, o /ueb é o diretório raiz do servidor web (document root). 
Portanto, ao digitar o endereço de seu site no navegador, você estará acessando os 
arquivos localizados dentro do diretório /web. 
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Testando a ferramenta 


Faremos agora uma pequena aplicação, somente para que você possa verificar se a 
Smarty foi instalada corretamente e se já está funcionando. Essa aplicação consiste 
apenas em exibir o valor de uma variável na tela. Crie um diretório chamado teste 
e, dentro dele, os diretórios configs, templates e templates c. 


Chamaremos o modelo de index.tpl e o programa PHP de index.php. O index.php 
deverá estar no diretório teste, € o modelo index. tpl deverá estar no diretório templates. 
O arquivo de modelo terá apenas duas linhas: 


index. tp] 
{* Smarty *} 
Olá f$nome}! 


A primeira linha ({* Smarty *}) é apenas um comentário, e você pode removê- 
la se desejar. De qualquer forma, é bom mantê-la para indicar que o arquivo em 
questão utiliza a linguagem da ferramenta Smarty. Lembre-se de salvar esse arquivo 
no diretório templates de sua aplicação. 


Criaremos agora o programa index.php, que irá criar uma instância da classe 
Smarty, atribuir um valor a uma variável chamada nome e chamar o arquivo de 
template para exibir a página ao usuário. Nesse exemplo, estamos considerando que 
o diretório da classe Smarty foi adicionado na diretiva include_path do php.ini. Se 
você não o tiver adicionado, forneça o caminho absoluto para o arquivo da classe 
(Smarty. class. php): 


index.php 


<?php 

require('Smarty.class.php'): 
$smarty = new Smarty: 
Ssmarty->assign('nome", Juliano"): 
$smarty->display(“index.tpl'): 

?> 


Ao acessar a página index.php no programa navegador, será exibida a seguinte 
frase: 


Olá Juliano! 


Se essa frase for exibida, a Smarty foi instalada com sucesso. Caso contrário, 
houve algum erro na instalação ou configuração. Nesse caso, verifique se você está 
indicando a localização correta da classe. Lembre-se também de que sua versão do 
PHP deve ser maior que ou igual a 406. 
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Informações sobre o layout 


Conforme explicado no início deste capítulo, o objetivo de uma ferramenta de 
templates é separar a lógica de exibição da lógica do programa. A partir de agora, 
iremos tratar da lógica de exibição, ou seja, das informações que precisamos saber 
para definir o layout das páginas. 


Tudo o que será apresentado nesse tópico se aplica aos arquivos de templates 
(.tpl) que iremos criar. Mais adiante, veremos um tópico só com informações sobre 
a lógica do programa que serão utilizadas nos programas PHP 


Delimitadores 


Os elementos da Smarty devem estar sempre entre os delimitadores utilizados 
pela ferramenta, que, por padrão, são “pe e “y” Utilizaremos esses delimitadores 
em nossos exemplos. Porém, você pode alterá-los se desejar, modificando o valor 
das variáveis $left delimiter e Sright delimiter no arquivo da classe Smarty (Smarty. 
class.php). Por exemplo: 


olá [nome 


Nesse caso, a variável $nome será avaliada pela Smarty, já que se encontra dentro 
dos delimitadores. Todo o conteúdo que se encontra fora dos delimitadores será 
estático, 


Comentários 


Dentro dos delimitadores, você pode incluir comentários para documentar os 


templates que criar. Para inserir um comentário, utilize o caractere “*” no início e 


no fim das tags delimitadoras. Por exemplo: 
{[* Smarty *} 
{* Exibir o nome do usuário *} 
Olá [$nome) <br> 


{+ Exibir o endereço do usuário *} 
Seu endereço é [Sendereco) 


Os comentários não produzem nenhuma saída na tela, pois servem apenas para 
documentação interna, facilitando o entendimento do código. 


318 PHP para quem conhece PHP 
Funções 


Além de colocar variáveis e comentários nas tags da Smarty podemos também 
incluir uma chamada para alguma função. Existem dois tipos de funções: 


= Embutidas — são as funções internas da Smarty que não podem ser modificadas. 
Exemplos: if, elseif, else, section. 


» Personalizadas (custom) — são funções adicionais, acrescentadas por meio de plug- 
ins. Você pode modificar essas funções se desejar. Exemplos: assign, eval, fetch, 
html options. Também estão incluídas nesse grupo as funções que você vier a 
criar. 


A sintaxe básica para a chamada de funções é a seguinte: 


{nome função atributol="valor" atributoZ="valor"...) 


Dependendo da função, podem existir ou não atributos relacionados a esta. Veja, 
a seguir, um exemplo envolvendo as funções include e if: 


{include file="cabecalho.tpl"F 
{if Snome eg “Juliano” 
Seja bem vindo! 
{else} 
Desculpe {$nome}, você não pode acessar esta página. 


{/if} 


Veja, a seguir, outro exemplo envolvendo uma função bastante utilizada, que é 
a section, Com essa função, podemos definir um laço para percorrer os valores de 
um array: 


Nome dos clientes: 

[section name=i Toop=fnomes! 
fSnomes [il k<br> 

{/section} 


A lista das funções embutidas e personalizadas, incluindo sua descrição e seus 
parâmetros, é apresentada ao final deste capítulo. 


Atributos 


Usar atributos na Smarty é bastante semelhante a usar atributos nas tags HTML, 
visto que servem para passar informações à função, definindo como será seu fun- 
cionamento. 
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Se você passar uma string como valor do atributo, procure utilizar aspas em torno 
dela. As aspas não são necessárias caso seja fornecida uma variável em vez de uma 
string, ou se o valor do atributo for lógico (como true, false, yes, no). Por exemplo: 


{include file="cabecalho.tplº3 

[include file=fnome arquivo? 

{include file=fnomearquivoê] 

[html select. date display days=yes) 

«SELECT name=lista> 

fhtml options values=fvalores selected=$selecionado output=fsaida) 
</SELECT> 


Variáveis 
Existem três tipos de variáveis que podem ser usadas em uma aplicação Smarty. 


«Variáveis definidas pelo PHP: iniciam com o caractere $. Podem ser variáveis simples, 
arrays indexados, arrays associativos ou objetos. Por exemplo: 


{$nome} 
ESdados [0]} 
{tdados . nome} 
{$dados->nome} 


= Variáveis definidas em arquivos de configuração: são definidas nos arquivos localizados 
no diretório configs da aplicação. Normalmente, utiliza-se a extensão .conf 
para esses arquivos. Para utilizar essas variáveis em seu template, delimite- 
as com o caractere “#” ou, então, utilize a variável especial $smarty. config. Por 
exemplo: 


{#nome#} 


ou 
{$smarty.config. nome} 


. Variável reservada ($smarty): por meio dessa variável, podemos acessar diversas 
informações sobre o template, o ambiente, obter o valor de cookies, de vari- 
áveis recebidas via método GET ou POST etc. Por exemplo: 


{* exibe o valor do cookie “nomeusuario” *} 

[$smarty. cookies. nomeusvario} 

[* exibe o valor da variável do servidor “SERVER NAME" *} 
fismarty server. SERVER NAMES 

{+ exibe o valor da variável de sessão “nome” *} 
[Esmarty.session.nomef 

{* data atual formatada *) 
[$smarty.now| date Format: "Ser -m-%d %H:1M:%5"} 
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Modificadores de variáveis 


O objetivo dos modificadores é produzir alguma alteração em uma variável, função 
personalizada ou string. Devem ser acrescentados ao lado desses elementos, sendo 
precedidos pelo caractere | (pipe). Por exemplo, para exibir o conteúdo da variável 
$nome com letras maiúsculas, teremos: 


{$nome | upper] 


É possível aplicar mais de um modificador a uma variável. Para isso, basta colo- 
cá-los em segiiência, separados pelo caractere | (pipe). A ordem de aplicação é da 
esquerda para a direita. Por exemplo, para exibir o conteúdo da variável gnome com 
letras minúsculas e um espaço entre cada caractere, teremos: 


fincme | Tower | spacify} 


Alguns modificadores podem receber parâmetros adicionais que irão afetar seu 
comportamento. Esses parâmetros devem ser especificados após o nome do modi- 
ficador, sendo precedidos pelo caractere : (dois-pontos). Por exemplo, para exibir 
apenas os 30 primeiros caracteres da variável $nome, teremos: 


{[$nome | truncate:30)] 


A seguir, será apresentada a lista dos modificadores da Smarty que você pode 
utilizar, assim como uma descrição do que cada um deles faz. 


Modificador Descrição 


capitalize Coloca em maiúsculas as primeiras letras de cada palavra contida 
na variável. 


count characters Retorna o número de caracteres de uma variável. 


cat Permite a concatenação de um valor ao conteúdo da variável. O 
valor a ser concatenado deve ser passado como parâmetro. 


count paragraphs Retorna o número de parágrafos existentes no conteúdo de uma 
variável. 


count sentences Retorna o número de frases existentes no conteúdo de uma variável, 


count words Retorna o número de palavras existentes no conteúdo de uma 
variável. 

date format Formata a data e a hora. Esse modificador permite aos designers 
ter o controle sobre o formato como a data deve ser exibida ao 
usuário. 

default Define um valor-padrão para uma variável. Esse valor deve ser pas- 


sado como parâmetro e será utilizado caso a variável esteja vazia 
ou não definida. 
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Formata o valor da variável de acordo com o tipo fornecido como 
parâmetro. Os tipos possíveis são html, htmlall, url, quotes, hex 


2 


Faz a endentação das linhas da string. Possui dois parâmetros op- 
cionais, para especificar o número de caracteres a ser endentados e 
o caractere a ser usado para fazer a endentação. 


Exibe o conteúdo de uma variável em letras minúsculas. 


Modificador Descrição (cont.) 
escape 
hexentity e javascript. O padrão é “html” 
indent 
Tower 
niZbr 


regex replace 


replace 


spacify 


string format 


strip 


strip tags 


truncate 


upper 
wordwrap 


Converte todas as quebras de linha para <br /> no conteúdo da 
variável, 


Realiza busca e substituição de expressões regulares em uma vari- 
ável. E 


Realiza busca e substituição em uma variável. 


Permite incluir um espaço entre cada caractere de uma variável. 
Você pode ainda especificar outro caractere ou string a ser usada 
em vez de um espaço. 


Formata uma string. Pode ser usada, por exemplo, para números 
decimais. À sintaxe é semelhante à do comando sprintf do PHE 


Substitui espaços, quebras de linhas e tabulações repetidas por um 
espaço simples ou com a string fornecida como parâmetro. 


Remove as tags de marcação, ou seja,ostrechos da string delimitados 
pelos caracteres < e >. 


Trunca uma variável em um determinado tamanho. Se nenhum 
tamanho for fornecido, será usado o valor-padrão (80). Opcional- 
mente, você pode definir um texto a ser exibido ao final, caso a 
variável seja truncada. 


Exibe o conteúdo de uma variável em letras maiúsculas, 


Define uma largura para cada coluna em uma string. Se nenhum 
tamanho for fornecido, será usado o valor-padrão (80). Opcional- 
mente, você pode especificar um segundo parâmetro, indicando o 
caractere ou string a ser usado na troca de linha. O padrão é n. 


Vejamos alguns exemplos do uso de modificadores em um template Smarty. 
Lembre-se de que os arquivos dos templates (.tp1) devem estar no diretório templates 
da aplicação. O exemplo a seguir utiliza o modificador capitalize para converter a 
primeira letra de cada palavra da variável $titulo para maiúscula: 


Exemplo 1 


index. php 
<?php 
requireC'Smarty.class.php': 


$smarty = new Smarty: 


$fsmarty->assign(' titulo", "Grêmio campeão do mundo. ); 
Ssmarty->display(“index.tpl'); 


?> 
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index. tpl 

{$titulo} <br> 
(Stitulo]capitalizel 
RESULTADO: 

Grêmio campeão do mundo. 
Grêmio Campeão Do Mundo. 


O próximo exemplo utiliza os modificadores count. characters, count sentences € 
count words para contar € exibir, respectivamente, O número de caracteres, número 
de frases e número de palavras da string atribuída à variável Stexto: 


Exemplo 2 


index. php 

<?php 

require('Smarty.class.php'); 

smarty = new Smarty; 

&smarty->assign('texto", 'O Grêmio é campeão do mundo. Além disso, o Grêmio é bicampeão da 


Libertadores. '); 
$suarty->display{'index. tpl"); 
?> 


index. tpl 

{$texto} <br> 

Esse texto possui (ftexto|count characters] caracteres, <br> 
Esse texto possui (Stexto]count sentences) frases. <br> 

Esse texto possui [Stextolcount words) palavras. 


RESULTADO: 
O Gremio é campeão do mundo. Além disso, o Grêmio é bicampeão da Libertadores. 


Esse texto possui 66 caracteres. 
Esse texto possui 2 frases. 
Esse texto possui 14 palavras. 


Veremos agora um exemplo envolvendo formatação de datas com o modifica- 
dor date format. Nesse exemplo, criou-se um template que formata e exibe a data 
30/09/1978 de três formas: 

DD/MM/AAAA 

DD-MM-AA 

MM/DD/ AAA 

Logo após, são exibidos a data e hora atual, obtidas por meio da variável reser- 
vada $smarty. A data será passada no formato timestamp (inteiro longo), para que o 
modificador as interprete e aplique a formatação especificada. Acompanhe, então, 
o terceiro exemplo apresentado a seguir: 
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Exemplo 3 


index.php 

<?php 

require('Smarty.class.php');: 

ismarty = new Smarty; 

$data nascimento = mktime (0, 0, O, 9, 30, 1978); 
$smarty->assign(' data", fdata nascimento); 
ismarty->display("index.tpl'); 

?> 


index.tp] 

fidata|date format :"%d/%m/%Y"} <br> 
{$data|date_format:"X%d-%m-%y"} <br> 

{fdata |date_format:"%m/%d/#Y"} <br> 

A data atual é {$smarty.now|date_format :"%d/%m/%Y"} <br> 
A hora atual é {$smarty.now]date_format:"#H:%M:%5"} 


RESULTADO: 

30/09/1978 

30-09-78 

09/30/1978 

A data atual é 07/08/2003 
A hora atual é 23:45:08 


A função mktime, usada no programa PHP, retorna o timestamp para a data forne- 
cida, que no caso foi 30/09/1978. 


O quarto exemplo que veremos envolve um modificador bastante útil, que é o 
truncate. Por exemplo, se uma loja virtual quisesse exibir em sua página inicial apenas 
o início da descrição dos produtos, poderia criar um template utilizando o modifi- 
cador truncate, para mostrar somente um determinado número de caracteres. 


Além de possibilitar a escolha do número máximo de caracteres da string resul- 
tante, o truncate ainda aceita um segundo e um terceiro parâmetros, que também 
são opcionais. No segundo parâmetro, você pode definir algum texio para ser 
(três pontos), 


Eh] 


acrescentado ao final da string truncada. Por padrão, esse texto é “... 
para indicar que a string continua. 


Já o terceiro parâmetro consiste em um valor lógico, que indica se o corte pode 
ser feito no caractere exato da posição indicada (true) ou se pode ocorrer somente 
ao final de uma palavra (false). Acompanhe o exemplo a seguir, que utiliza o mo- 
dificador de diversas formas: 
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Exemplo 4 


index. php 

<?php 

require(' Smarty. class.php'); 

$smarty = new Smarty; 

Ssmarty->assign(' descricao", 'O PostgreSQL é um Sistema Gerenciador de Bancos de Dados 
relacional e orientado a objetos. Oferece mecanismos eficientes de segurança e 
integridade de dados. 9; 

£smarty->display (index. tpl"); 

?> 


index.tp] 

[Sdescricao|truncate) <br> 
fidescricao|truncate: 307 <br> 
T$descricao|truncate:30:"") <br> 
{$descricao|truncate:30:"":true} <br> 
Iidescricao|truncate:30:"...“itrue) 


RESULTADO: 

O PostgreSQL é um Sistema Gerenciador de Bancos de Dados relacional e... 
O PostgreSQL é um Sistema... 

O PostgreSQL é um Sistema 

O PostgreSQL é um Sistema Gere 

O PostgreSQL é um Sistema G... 


Veja que, na primeira linha do template, como não foi fornecido parâmetro para 
definir o tamanho da string resultante, a Smarty utilizou o valor-padrão (80 carac- 
teres). Repare também na diferença entre a terceira e a quarta linha do resultado, 
assim você poderá perceber o efeito do terceiro parâmetro do modificador truncate. 
Na quarta linha, o corte foi feito na posição exata (no caso, 30), enquanto na terceira 
o corte foi feito ao final da palavra anterior. 


Arquivos de configuração 


Os arquivos de configuração, que devem estar localizados no diretório configs da 
aplicação, são de grande utilidade para os designers. Pode-se manter nesses arquivos 
todas as variáveis globais, que serão usadas em várias páginas. Por exemplo, poderia 
ser definida uma variável global contendo a cor de fundo das páginas. Se o designer 
quiser trocar essa cor, bastará editar um único arquivo e a nova cor será aplicada 
em todos os templates que utilizarem essa variável. 


Para utilizar um arquivo de configuração em um template, devemos carregá-lo 
com a função config load. Por exemplo: 


fconfig load file="teste.conf'> 
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Para ver a sintaxe e a descrição dos parâmetros dessa função, consulte a lista de 
funções da Smarty ao final deste capítulo. 


Algumas considerações em relação aos arquivos de configuração: 


* Para incluir comentários nesses arquivos, procure utilizar o caractere # no 
início da linha. 


"= Não é obrigatório o uso de aspas em torno dos valores das variáveis. 


* Valores que ocupam mais de uma linha devem ser delimitados por aspas 
triplas ©”). 


" É possível criar seções de variáveis e, posteriormente, carregar apenas as seções 
desejadas. O nome das seções deve estar entre colchetes (1 ]). 


"As variáveis globais, definidas fora das seções, serão sempre carregadas quando 
o arquivo for carregado. 


= Se existir uma variável global e uma de seção com o mesmo nome, será con- 
siderada a da seção. 


« É possível ocultar variáveis ou seções inteiras. Isso é útil nos casos em que as 
variáveis serão usadas apenas pelo programador, não interessando ao criador 
dos templates (ex.: informações sobre o banco de dados). Para ocultar variáveis 
ou seções, acrescente um ponto (J antes de seus nomes. 


Veja, a seguir, um exemplo de arquivo de configuração onde se definiram a cor 
de fundo da página, a cor do título, o texto do título e as margens. Esse arquivo 
será nomeado como index. conf. 


index.conf 


# variáveis globais 

titulo = “Esta é a Smarty!!!" 
corFundo = #060606 

corTitulo = #0009FF 


[Margens] 
margemSuperior = 10 
margemEsquerda = 10 


Esse arquivo deve estar no diretório configs, e para poder utilizar o valor dessas 
variáveis no template, podemos chamá-lo da seguinte forma: 


fconfig load file="index.conf”) 
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Porém, se o chamarmos assim, estarão disponíveis apenas as variáveis globais, 
ou seja, aquelas definidas fora da seção [Margens]. Para poder utilizar todas elas, 
devemos acrescentar o parâmetro section na função config load. Veja a seguir como 
poderia ser o template index.tpl nesse caso; 


index.tpl 


[config load file="index. conf" section="Margens") 

<html> 

<head> 

<title>{[#titulo#}</title> 

</head> 

<body bgcolor=" {#corFundo#}" topmargin="{#margemSuperior#}" leftmargin="{#margemEsquerda#} "> 
<ħ1 align="center"> 

<font face="Arial" color=" {#corTitulo#}">{#titulo#}</font> 
</hl> 

</body> 

</html> 


Utilizando o parâmetro section na função config load, estamos tornando dispo- 
níveis ao template tanto as variáveis globais quanto as variáveis definidas dentro 
da seção [Margens]. No momento que o programa PHP solicitar a exibição do tem- 
plate, a Smarty irá substituir as variáveis por seus respectivos valores e, logo após, 
exibir a página ao usuário. Se você quiser testar o template index.tpl, bastará fazer 
um simples programa PHP para criar uma instância da classe Smarty e solicitar a 
exibição do template: 


index.php 


<?php 
require Smarty. class.php'3; 
fsmarty = new Smarty; 
$smarty->display{'index. tpl"); 
7> 


Ao executar esse programa no navegador, será exibida uma página com fun- 
do cinza (cor #D6D6D6) e com o título “Esta é a Smarty!!!” escrito em azul (cor 
#0000FF), como mostra a figura 93. 
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Figura 9.3 — Utilizando o valor das variáveis de configuração. 


Informações sobre a programação PHP 


Agora que você já conhece os princípios básicos para a definição do layout por meio 
da criação de templates, iremos tratar da lógica do programa PHP, que inclui as 
variáveis e métodos da classe Smarty que podemos utilizar em nossos programas, 
antes de exibir o template, 


À constante SMARTY. DIR 


Conforme citado no início deste capítulo, a Smarty permite o uso de uma constante 
chamada SMARTY. DIR para armazenar o caminho do sistema onde estão localizados 
os arquivos da classe. 


Você pode definir o valor dessa constante no início de sua aplicação, antes de 
incluir uma chamada para a classe. Por exemplo: 


defineC'SMARTY DIR", '/usr/local/lib/php/Smarty/; 
require(SMARTY DIR. 'Smarty.class.php'); 
smarty = new Smarty; 


Note que o caminho do sistema deve terminar com uma barra. Se utilizar a 
constante SMARTY DIR sem defini-la antes, a Smarty automaticamente tentará definir 
esse valor. 
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A classe Smarty possui diversas variáveis de configuração que podem ser alteradas 
pelo programador. Você pode alterar o valor dessas variáveis de duas formas: 


1. Diretamente no arquivo da classe (Smarty.class.php). Nesse caso, o valor que 
você definir torna-se o padrão. Porém, esse método não é recomendável, pois 
se você instalar uma nova versão da classe Smarty, irá perder os valores que 


definiu. 


2. De dentro do programa PHP digitando: 


fsmarty->nome variável = valor; 


onde $smarty é o objeto da classe Smarty nome variável é um dos nomes apresenta- 
dos a seguir (não incluindo o caractere $) e valor é o novo valor dessa variável para 


o objeto em questão. 


A seguir, será apresentada a lista de variáveis da classe Smarty, assim como uma 


descrição de cada uma delas. 


Variável 


ftemplate dir 


fcompile dir 


fconfig dir 


fplugins dir 


$debugging 


$debug tpl 


Descrição 

Diretório-padrão dos templates. O padrão é templates, ou 
seja, os arquivos serão procurados em um diretório chamado 
templates localizado no mesmo diretório do programa PHP 
que estiver em execução. 


Diretório-padrão onde serão armazenados os templates 
compilados. O padrão é templates c, a gravação será feita 
em um diretório chamado templates. « localizado no mesmo 
diretório do programa PHP que estiver em execução. 


Diretório-padrão dos arquivos de configuração. O padrão é 
configs, ou seja, os arquivos serão procurados em um diretório 
chamado configs localizado no mesmo diretório do programa 
PHP que estiver em execução. 

Diretório no qual a Smarty irá procurar pelos plug-ins 
necessários. O valor-padrão é plugins, localizado abaixo do 
diretório definido pela constante SMARTY. DIR. 

Habilita o painel de depuração (debugging console), que 
consiste em uma janela JavaScript contendo informações 
sobre as variáveis e os templates incluídos dentro de um 
template. 

Nome do arquivo de template usado para o painel de depu- 
ração. O padrão é o arquivo debug. tpl, que está localizado 
no diretório definido pela constante SMARTY DIR. 
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Variável 


Descrição (cont.) 


idebugging ctrl 


fglobal assign 


fundefined 


Sautoload filters 


fcompile check 


gforce compile 


fcaching 


fcache dir 


Scache lifetime 


fcache handler. func 


É considerado somente quando o depurador estiver desa- 
bilitado ($debugging=false). Permite a definição de formas 
alternativas de depuração. Se for igual a NONE, não permitirá 
formasalternativas.Se foriguala URL, habilitará o depurador 
se a palavra-chave SMARTY, DEBUG for encontrada na URL. 


Utilizada para criar variáveis globais de forma implícita, 
tornando-as disponíveis a todos os templates. 


Indica o valor-padrão que deve ser usado para variáveis 
indefinidas no array $global assign. 


Utilizado para carregar filtros a cada ativação de um template. 
É um array associativo, contendo o tipo (chave) e o nome 
(valor) dos filtros a ser carregados. 


Esse valor será considerado apenas se o template já tiver 
sido compilado. Indica se deve ser checado, se houve alguma 
modificação no template desde sua última compilação. Se 
houve modificação, será compilado novamente. O padrão 
é true, Se seus templates não irão sofrer mudanças, colocar 
esse valor como false é uma alternativa para melhorar o 
desempenho da aplicação. Porém, se seus templates forem 
modificados, essas alterações só terão efeito se esse valor for 
igual a true. 


Deve ser usada somente para fins de depuração, para forçar 
a compilação dos templates a cada chamada. O valor-padrão 
é false. Se habilitada, a variável fcompile. check não terá efeito 
algum. 


Indica se os arquivos gerados devem ser armazenados em uma 
cache, para posteriormente serem reutilizados e melhorar o 
desempenho da aplicação. Por padrão, essa funcionalidade 
é desabilitada. É recomendável habilitá-la principalmente se 
houver bastante conteúdo redundante gerado pelos templates. 
O conteúdo da cache será atualizado sempre que houver 
uma nova compilação. 


Diretório-padrão dos arquivos de cache. O padrão é cache, ou 
seja, os arquivos serão gravados em um diretório chamado 
cache localizado no mesmo diretório do programa PHP que 
estiver em execução. 


Será considerado somente quando a funcionalidade de 
cache estiver habilitada (caching=true). Define o número de 
segundos que um arquivo de cache é válido. Utilize o valor 
-l para indicar que a cache nunca irá expirar. 


Permite o uso de uma função personalizada para O trata- 
mento dos arquivos da cache, em vez de utilizar o método 
embutido. 
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Variável 
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Descrição (cont) 


Scache modified check 


$config. overwrite 


config booleanize 


Sconfig read hidden 


$config fix newlines 


Se habilitado, irá avaliar o cabeçalho de última medificação 
enviado pelo cliente. Se o arquivo de cache não tiver sido mo- 
dificado desde essa data, será retornado, em vez do conteúdo, 
um cabeçalho indicando que não houve modificação. 


Indica seas variáveis dos arquivos de configuração devem ser 
sobrescritas. Por padrão, essa funcionalidade está habilitada. 
Se você desabilitá-la, as variáveis de mesmo nome serão 
colocadas em um array. 

Habilita ou desabilita a conversão dos valores of on/true/yes 
e off/false/no para valores lógicos. Por padrão, essa funcio- 
nalidade está habilitada. 

Indica se as seções ocultas, ou seja, aquelas cujo nome é 
precedido por um ponto, poderão ser lidas pelos templates. 
O padrão é false. 

Indica se as quebras de linhas estilos MAC e DOS Ar e 
Yin) devem ser convertidas para \n no momento da com- 
pilação. 


idefault template handler func 


Sphp handting 


fsecurity 


Ssecyre dir 


fsecurity settings 


itrusted dir 


Sleft delimiter 


$right delimiter 


Permite especificar uma função PHP para ser executada caso 
o template não seja localizado. 


Define como devem ser manipuladas as tags do PHP (<?phpe 7»), 
casosejam encontradas dentro do template. Os valores possíveis 
são SMARTY PHP. PASSTHRU (é o valor-padrão - exibe como texto), 
SMARTY PHP QUOTE (trata como uma entidade), SMARTY. PHP. REMOVE 
(remove as tags) e SMARTY. PHP. ALLOW (executa). 


Se habilitada, a Smarty aplicará uma série de regras para 
aumentar a segurança do sistema, como, por exemplo, proi- 
bir a execução de códigos PHP dentro do template e o uso 
de funções PHP em comandos IF, restringir a inclusão de 
arquivos a determinados diretórios, entre outros. O valor- 
padrão é false. 

Array contendo os diretórios que são considerados seguros. 
Será consultado se a variável de segurança estiver habilitada 
(Ssecurity=true). 

Array associativo contendo alguns parâmetros de configu- 
ração relativos à segurança. Será avaliado quando a variável 
de segurança ($security) estiver habilitada. 

Array contendo os diretórios onde estão localizados os scripts 
PHP executados pelos templates. Será avaliado quando 2 
variável de segurança ($security) estiver habilitada. 

Define o delimitador da esquerda que será utilizado pela 
linguagem de templates. O padrão é “1%. 

Define o delimitador da direita que será utilizado pela lin- 
guagem de templates. O padrão é “}“. 


: 
| 
j 
i 


| 
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Variável Descrição (cont.) 


$compiler.class Define o nome da classe que será utilizada pela Smarty para 
compilar os templates. 


frequest vars order Define a ordem na qual as variáveis de requisição serão re- 
gistradas. O padrão é EGPCS (E= Ambiente, G=GET, P=POST, 
C=Cookies, S=Servidor). 


Srequest use auto globais Indica quais os arrays predefinidos do PHP a Smarty deve 
utilizar. Se for especificado o valor false (padrão), serão uti- 
lizados os arrays do tipo fHTTP.* VARS[], caso contrário serão 
utilizados os arrays do tipo $.*[]. 


Scompile id Permite gerar mais de um arquivo compilado para um 
mesmo template. Por exemplo, se você for utilizar mais de 
um idioma, a compilação pode gerar um arquivo pata cada 
idioma, baseando-se no mesmo template. 


Suse sub dirs Indica se a Smarty pode criar subdiretórios nos diretórios 
templates c e cache. O valor-padrão é true. 


$default modifiers Array onde pode ser armazenada umalista de modificadores, 
queserão aplicados a todas variáveis dos templates. Se houver 
modificadores nessa lista e você não quiser aplicá-los a uma 
determinada variável, utilize o modificador no defaults. Por 
exemplo: (fvariavel |nodefaults+. 


Métodos 


Além de poder manipular as variáveis da classe, temos a nossa disposição um con- 
junto de métodos que podem ser chamados por um objeto da classe Smarty em um 
programa PHP. Para chamar um método, procedemos da seguinte forma: 


$smarty->nome metodo([Vista parametros); 


onde $smarty é o objeto da classe Smarty, nome metodo é o nome de um método 
existente na classe Smarty e [lista parametros] são os parâmetros (se existirem) do 
método especificado, Os parâmetros são separados por vírgulas, 


Um dos métodos mais utilizados é o assign, que tem a função de atribuir valores 
às variáveis que serão utilizadas nos templates. Veja alguns exemplos: 

fsmarty->assign("Nome”, “Juliano Niederauer"); 

Ssmarty->assign("Profissao", "Escritor"); 


$smarty->assign("Email", "julianoêniederauer com.br"); 
Esmarty->assign(" Site", “http: //mumw.niederauer com.br"); 


Como você pôde perceber nos exemplos apresentados, existe também o método 
display, que provavelmente será utilizado em todas suas aplicações Smarty. Esse é o 
método responsável por exibir o template. Por exemplo: 


Ssmarty->display("index.tpl"); 
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A lista dos métodos da Smarty é apresentada ao final deste capítulo, assim como 
a sintaxe e descrição de cada um deles. 


Exemplos de aplicações com Smarty 


São inúmeras as aplicações que podemos criar utilizando a Smarty Veremos agora duas 
delas: um catálogo de livros e um sistema de exibição de notícias. Acompanhe, então, 
os dois exemplos a seguir, pois por meio deles você irá conhecer algumas utilidades 
da ferramenta e poderá inclusive adaptá-las para criar suas próprias aplicações. 


Lembre-se sempre de que para cada aplicação Smarty devem ser criados os dire- 
tórios requeridos pela ferramenta (configs, templates e templates. 0). Se a funcionalidade 
de memória cache estiver habilitada, crie também um diretório chamado cache com 
permissão de escrita. 


Catálogo de livros 


A aplicação que será apresentada neste tópico exibe uma tabela HTML contendo 
uma lista de livros e seus respectivos autores. Os nomes dos livros e dos autores serão 
armazenados em dois arrays, chamados $array. livros € $array autores. Primeiramente, 
para facilitar o entendimento do programa, vamos definir valores fixos para esses 
arrays e, logo após, veremos como obter esses valores a partir de uma consulta feita 
em um banco de dados MySQL. 


Serão utilizados dois arquivos: o programa index. php e o template index. tpl, e esse 
último deve estar localizado no diretório templates. Portanto, a estrutura de arquivos 
e diretórios será a seguinte: 


index.php 


configs/ 
templates/ 
index.tp] 
templates c/ 


O programa index.php é bastante simples. Nele são definidos os valores para os 
dois arrays (inicialmente de forma fixa), são criadas as variáveis do template por 
meio do método assign e é solicitada a exibição do template index. tpl: 
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<?php 

$titulo = "Livros da Novatec Editora”; 

farray livros = array( 
"Desenvolvendo Websites com PHP 4", 
“Proteção Juridica de Software”, 
"Virtual Private Network”, 
"ASP.NET Guia do Desenvolvedor” 

J 

Sarray autores = array( 
"Juliano Niederauer”, 
"Alexandre Coutinho Ferrari", 
"Lino Şarlo da Silva”, 
"Felipe Cembranelii" 

Ji 


requireC Smarty.class.php'); 

$smarty = new Smarty; 
Ssmarty->assignQ"titulo", Stitulo); 
$smarty->assign("livros", Sarray livros); 
$smarty->assign("autores", Sarray autores); 
$smarty->display("index. tpl"); 

7> 


Veremos agora como criar o template index.tp1, que deve percorrer o array de 
livros (que agora estará disponível na variável $livros do template) e exibi-los em 
uma tabela HTML, com seus respectivos autores. 


Nesse exemplo, além de utilizarmos o recurso de substituição de variáveis da 
Smarty serão utilizadas também duas funções dessa ferramenta: a section, que irá 
criar o laço para percorrer os elementos do array e a cycle, para exibir as linhas da 
tabela com cores alternadas (serão aplicados dois tons de cinza). Para o cabeçalho da 
tabela, usado apenas para descrever as colunas, será usada a cor amarela (#FFEFF00). 
Acompanhe o código do template a seguir: 


index.tpl 


<html> 
<head> 
<title>{$titulo}</title> 
</head> 
<body> 
<h? align="center">{$titulo}</h2> 
<table> 
<tr bgcolor=" #FFFF00"> 
<td>eb>Livro</b></td> 
<td><b>Autor</b></td> 
</tr> 
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{section name=i loop=$livros} 
<tr bgcolor="{cycle values="#eeeeee , #d0d0d0"}"> 
<td>{$livros [i] </td> 
<td>{$autores[i]}</td> 
</tr> 
{section} 
</table> 
</body> 
</html> 


Ao analisar esse template, você irá perceber que existem três trechos de códigos 
dinâmicos. O primeiro é a definição do título da página, onde utilizamos a variável 
$titulo do template: 


«title>iftitulol</title> 


O segundo é o texto do cabeçalho da página, para o qual se utilizou essa mesma 
variável: 


<h2 align="center">[Stitulok</h2> 


O terceiro, e o mais importante, é o laço criado com a função section para a cria- 
ção das linhas da tabela HTML, com a função cycle para alternar as cores dessas 
linhas. Veja que a variável que define o nome do laço foi utilizada como índice para 
acessar tanto o array de livros como o de autores: 


{section name=i Toop=$livros) 
«tr bgcolor="fcycle values="teceeee, #d0d0d0"}"> 
<td>{$livros[i]}</td> 
<d>{$autores[i}}</td> 
«</tr> 
{section} 


O restante do código é HTML puro. Se você ainda tinha dúvidas quanto à uti- 
lidade das ferramentas de templates, esse exemplo mostra que o código torna-se 
muito mais simples, fácil de ser entendido e mantido. Ou seja, é muito mais simples 
inserir as tags da Smarty do que diversos blocos de programação PHP no mejo do 
código HTML. 


Dessa forma, além de obter facilidade no controle sobre a exibição dos dados, 
não corremos o risco de alterar de forma indevida a lógica do programa, pois estará 
em um arquivo separado. 


Veja na figura 94 o resultado da execução do programa index.php no programa 
navegador. 
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1) hitpr/Zlocalhost/smaityi livros o . 


Livros da Novatec Editora 


Livro Autor 


twork, 


Figura 9.4 — Exibição do template index.tpl chamado pelo index.php. 


Conforme se citou no início desse tópico, veremos agora como alterar o programa 
index.php para que as informações (livros e autores) sejam obtidas dinamicamente a 
partir de um banco de dados MySQL, em vez de serem definidas de forma fixa. Para 
isso, vamos utilizar uma tabela MySQL chamada livros, a mesma que foi utilizada 
como exemplo no Capítulo 8. Essa tabela foi criada da seguinte forma no utilitário 


mysql: 


create table livros 


( 
isbn varchar(13), 
titulo varchar(80) NOT NULL, 
autor varchar(80) NOT NULL, 
paginas smallint NOT NULL, 
preco float NOT NULL 

j); 


Esse código de criação da tabela, assim como o código para a inclusão de alguns 
registros para fins de testes, está disponível no site da Novatec Editora em um arquivo 
chamado create.sql, no endereço indicado no início deste livro. 


Vamos alterar, então, o programa index.php para que os dados sejam obtidos 
de forma dinâmica. O programa resultante, apresentado a seguir, será nomeado 
index bd. php. 


Esse programa abre uma conexão com um banco de dados MySQL e faz uma 
consulta (select) para retornar os livros por ordem alfabética. Os dados retornados 
são colocados nos artrays $array livros € farray autores, que posteriormente são 
atribuídos a variáveis do template: 


336 PHP para quem conhece PHP 


index bd.php 


<?php 

$titulo = "Livros da Novatec Editora”; 
ff acesso ao banco de dados 

Sservidor = "localhost"; 

Susuario = "juliano"; 

fsenha = "12345"; 

Sbanco = "test"; 


fcon = mysql connect(fservidor, Susuario, Ssenha); 
mysql select dh (fbanco); 
tres = mysql. query("seltect titulo,autor from livros order by titulo"); 
$num linhas = mysql numrows(Sres); 
for ($i = 0; $i < $num linhas; $i++ 
1 
Sarray. livros[] = mysql resultífres,$1,0); 
Sarray autores[] = mysgl result(gres,5i,1): 
f 


mysql close(fcon): 


ff define variáveis e exibe o template 
requireC'Smarty.class.php'); 

$smarty = new Smarty; 

$smarty->assign(" titulo”, Sritulo); 
$smarty->assign(" livros", Sarray livros): 
$smarty->assign("autores", Sarray autores); 
&smarty->display("index.tpl"); 

?> 


Altere as variáveis de acesso ao banco de dados ($servidor, $usuario, $senha e $banco) 
de acordo com as configurações de seu servidor. Veja que, nesse exemplo, os arrays 
que armazenam os dados da tabela (Sarray. livros e Sarray autores) tiveram seus va- 
lores definidos de forma dinâmica, por meio de um laço que percorre os registros 
resultantes da consulta SQL: 


for ($i = O; $i < &num linhas; $i++) 
i 
farray livros[] = mysql result(Sres, $i, 0): 
Sarray autores[] = mysql resultífres, $i, 1); 


} 


Note que o template index.tpl permanece o mesmo. Foi necessário apenas alte- 
rar o programa PHP, já que a mudança feita afeta apenas a lógica do programa, e 
não a lógica de exibição. Veja na figura 95 o resultado da execução do programa 
index bd, php no programa navegador. 
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Rubens Prates 
ESSE 


Figura 9.5 — Exibição do template baseado nos dados de uma tabela MySQL. 


Sistema de notícias 


Outra aplicação interessante que pode ser criada com o uso de templates é um 
sistema de notícias. Esse sistema pode consultar um banco de dados para exibir 
sempre as últimas notícias cadastradas, mostrando somente o trecho inicial do 
texto e oferecendo ao usuário um link para visualização da notícia completa, como 
ilustra a figura 96. 


Hoia 1 
bia bta bla bla bla bla 
bla Eta bla bla.. feia maish 


Núlícia 2 


bla bla Bla bla bla bta 
bla bla bla bla... [eia país) 


| Noticia 4 
bia bla bla bia bla bla 
bia bla wa bla... Lata maist 


Figura 9.6 — Estrutura do sistema de notícias. 
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Para implementar esse sistema, primeiramente vamos criar no MySQL (por meio 
do utilitário mysql) uma tabela chamada noticias, da seguinte forma: 


create table noticias 


( 
id mediumint NOT NULL AUTO INCREMENT, 
titulo text NOT NULL, 
texto text NOT NULL, 
data hora datetime NOT NULL, 
primary keyCid) 
Ji 


Esse código de criação da tabela, assim como o código para a inclusão de al- 
guns registros para fins de testes, está disponível no site da editora em um arquivo 
chamado create.sql, no endereço indicado no início desse livro. 


O campo id será o número que irá identificar a notícia e, posteriormente, será 
passado como parâmetro para a página que irá exibir a notícia completa, Além 
desse identificador, cada notícia vai possuir um título e um campo para armazenar 
a data e hora (datetime) de sua publicação. 


Esse campo de data e hora será de grande importância não só para exibir essas 
informações ao usuário, mas também para ordenar os dados resultantes da consulta 
SQL. A consulta feita com o comando SQL select irá ordenar os registros resul- 
tantes por data e hora de forma decrescente, além de limitar o número de notícias 
retornadas utilizando a cláusula SQL limit. Dessa forma, serão retornadas apenas 
as notícias mais atuais. 


Acompanhe, então, como ficará o programa index.php dessa aplicação. Esse 
programa faz uma conexão ao banco de dados, obtém as notícias mais atuais, ar- 
mazena-as em arrays e solicita a exibição do template (que será apresentado logo a 
seguir). No site da Novatec Editora, você encontrará também a versão desse script 
para a extensão MySQLi. 


index.php 


<?php 

/! acesso ao banco de dados 

Sservidor = “Tocalhost” 

Susuario = "juliano"; 

senha = "12345"; 

Sbanco = "test"; 

$con = nysq? connect($servidor, $usuario, $senha); 
mysql. select db ($banco); 
$res = mysql query("select * from noticias order by data hora desc limit 3"); 
fnum Vinhas = mysql numrows(Sres); 
for ($i = 0; $i < &num linhas; $i++) 
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{ 
$array_ids{[] = mysql-result($res,$i,"id"); 
farray titulos[] = mysql result(Sres,Si,"titulo"); 
Sarray textos[] = mysql result(Sres, $i, "texto"; 
tarray datas[) = mysql result($res,$i,"data hora"); 
ł 


mysql close($can); 

ff define variáveis e exibe 0 template 
reguire('Smarty.class.php'); 

{smarty = new Smarty; 
&smarty->assign("ids", Sarray ids); 
Ssmarty->assign("titulos”, Jarray titulos); 
ismarty->assign(" textos", Sarray textos); 
$smarty->assign("datas”, farray datas); 
$smarty->display("index. tpl"); 

T> 


Veja que foram utilizados quatro arrays para armazenar os resultados, sendo um 
para cada coluna da tabela. Esses valores foram atribuídos a quatro variáveis que 
serão consultadas no template: $ids, Stitulos, $textos e Sdatas. Nesse exemplo, esses 
arrays contêm as três notícias mais atuais existentes em seu banco de dados, visto 
que utilizamos a cláusula SQL limit com o valor 3. Porém, você pode aumentar ou 
reduzir esse valor se achar necessário. 


Chegou o momento de criar o template para essa página, ou seja, de definir 
como essas três notícias devem ser exibidas pelo sistema. A idéia é exibir uma ta- 
bela HTML contendo apenas o trecho inicial de cada uma delas (150 caracteres), 
disponibilizando ao lado um link para que o usuário possa visualizar a notíca 
completa. Para isso, serão utilizados alguns recursos da Smarty que, em seguida, 
serão explicados. Acompanhe, então, o template index. tpl, apresentado a seguir, que 
deve estar localizado no diretório templates da aplicação: 


index.tp! 


<html> 
<body> 
<div align="center"> 
«table border="0" celispacing="0" width="60%"> 
<tr> 
«td width="50%" bgcolor="BESESES"> 
<font size="5">Confira as últimas notícias! </font> 
</td> 
<td width="50%" bgcolor=" #E8E8E8"> 
<p align=" right"><b>{$smarty.now|date_format:"%d/#m/%Y"}</b> 
</td> 
</tr> 
<tr> 
<td width="100%" colspan="2" bgcolor=" #FBFBFB"><pr> 
{section name=i loop=$titulos} 
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«p><h><u>[Stitulos [5])</u></b> 
<i>(Lídatas[i] date. Format: "Kd/%m/%Y EH D</i>ebr> 
fStextos[i] |truncate: 150) 

[<a href="mostra noticia.php7id=fSids[ill">Leia mais</a>]</p> 


[/section) 
</td> 
</tr> 
</table> 
</div> 
</body> 
</html> 


Nesse programa foram utilizados diversos recursos da Smarty, como funções, 
modificadores e substituição de variáveis. Vamos analisar apenas as partes que 
contêm tags da Smarty visto que o restante do código é HTML puro. 


Na primeira linha da tabela HTML, utilizou-se a variável especial $smarty para 
obter a data atual, com o modificador date_format para exibi-la no formato DD/ 
MM/AAAA: 


{fsmarty.nowldate_format:"%d4/%m/%Y"} 


A segunda linha da tabela HTML foi utilizada para exibir as notícias, uma em 
cada parágrafo. O laço para obter e exibir cada uma dessas notícias foi criado pela 
função section em torno do array que contém o título delas: 


[section name=i loop=$titulos} 


Dentro do laço, o nome da seção (i) foi usado como índice para acessar nossos 
quatro arrays (identificadores, títulos, textos e datas). Para exibir a data e hora de 
publicação da notícia, aplicou-se o modificador date format para indicar o uso do 
formato DD/MM/AAA HH:MM: 


{$datas[i] |date_format : "%d/%m/%Y %H:%M"} 


Em relação ao texto da notícia, utilizou-se o modificador truncate para exibir 
apenas seus 150 primeiros caracteres, Após exibir o número de caracteres especifi- 
cado, esse modificador acrescenta automaticamente os três pontos (...) ao final, para 
indicar que o texto continua: 


fitextos[i] |truncate:150F 


Por fim, acrescentou-se um link ao lado de cada notícia com o texto “Leia Mais” 
Esse link chama o programa nostra noticia. php para exibir a notícia completa e passa 
como parâmetro seu identificador: 


<a href="mostra noticia. php?id=(fids[1]J">Leia mais</a> 
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O resultado da execução do programa i 
sentado na figura 96. 
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ndex.php no programa navegador é apre- 


Pronto! A página principal do sistema de notícias está finalizada. Para concluir o 
sistema, ainda falta criarmos o programa que irá exibir a notícia completa quando 


o usuário clicar o link “Leia mais”, 


Como estamos estudando o uso de templates, nada melhor do que separar essa 


parte da aplicação em dois arquivos: 


Arquivo Descrição 
mostra noticia.php Programa que irá 
MySQL. 


mostra noticia.tpl Template que irá d 


obter as informações no banco de dados 


efinir como a notícia será exibida. 


E ia 


El Egereço JE] tt /Mpcshasiomatuinntimas! o o 


Confia as últimas notícias! 


isog2003 


Clássico do fotebol mimdial na luta pelo ouro (3 082003 10:35) 
Üm clássico do futebol mundhal decide ¢ tomeio masculino dos Togos Pan-Amencanos 
de Santo Donge Brasil e Argentina se enfrentam, as 19h desta... [Lema mas] 


Brasil bate recorde de medalhas (7 SOYI 10:25) 
A participação brasileira nos Jogos de Sento Domingo é a melhor da históna em Pan- 


Amencanos. O país bateu seu próprio recorde 


do total medalhas e. . [Lera mais 


Erasil é ouro no revezamento 4x1Q0m nado livre E y08/2003 10:15) 


Brasil é ouro no revezamento SELAGI Aa 


O Brasil conquistou o ouro na prava do revezamento 4x100m nado hore dos Jogos 
Pan-Amencanos de Santo Domingo, Repúbhca Donumeana. Femando. [Leia mas] 


Figura 9.7 — Sistema de no 


rícias utilizando a Smarty. 


Portanto, o sistema de notícias ficará com os arquivos € diretórios organizados 


da seguinte forma: 


index. php 
mostra noticia.php 
configs/ 
templates/ 

index. tpl 

mostra noticia. tpl 
templates c/ 


O programa mostra noticia.php abre uma conexão com o banco de dados e faz 
uma consulta SQL para obter o registro da notícia, cujo identificador foi passado 


como parâmetro. Lembre-se de que os p 
meio da URL) podem ser acessados pelo 


arâmetros passados via método GET (por 
array $.GET do PHP. 


342 PHP para quem conhece PHP 


As informações sobre a notícia são colocadas em três arrays ($titulo, $texto e 
$data) antes da solicitação da exibição do template. O código do programa é apre- 
sentado a seguir: 


mostra noticia.php 


<?php 

fid noticia = $_GET{'id']; 

ff acesso ao banco de dados 

fservidor = "localhost"; 

fusuario = "juliano"; 

isenha = "12345"; 

Sbanco = "test"; 

$con = mysql_connect($servidor, Susuario, $senha); 
mysql select. db (Sbanco); 
$res = mysql query("select titulo, texto, data hora from noticias where id=tid noticia"); 
$num linhas = mysql numrows(Sres); 
if Cum linhas > 0) 


{ 
$titulo = mysql result($res,0,"titulo"); 
ftexto = mysql result(tres,0,"texto"): 
$data = mysql result(jres,0,"data hora"); 
k 


mysql close($con); 

/f define variáveis e exibe o template 
require('Smarty.class.php'); 

ismarty = new Smarty; 
$smarty->assign("titulo”, $titulo); 
Esmarty->assign("texto", texto); 
Esmarty->assign("data”, $data); 


Esmarty->display("mostra noticia. tpl"): 
?> 


Para finalizar, veremos agora uma maneira de criar o template para definir como 
a notícia será exibida, o mostra noticia.tpl. Será utilizada a seguinte formatação: 


= fonte tamanho 5 para o título da notícia; 

= data e hora logo abaixo, em itálico; 

* uma linha horizontal (<hr>) para separar o cabeçalho da notícia do texto; 
=" texto da notícia, com a fonte-padrão; 

* link para o usuário voltar à página anterior. 


Acompanhe a seguir como ficará esse template: 
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mostra, noticia.tpl 


<html> 
<head> 
«title fttitulo)«/title> 
</head> 
<body> 
<p> 
<font size="5">{$titulo}</font><br> 
<i>{$dataldate_format:"Data: %d/%m/%Y Hora: HM Pe/i> 
</p> 
<hr> 
<p>{$texto}</p> 
<p align="center"><a href="javascript:history.back()">Voltar</a></p> 
</body> 
</ħtml> 
Veja que para exibir a data, utilizou-se o modificador date format, passando 
como parâmetro uma sting contendo dados fixos com os indicadores de conversão 


(precedidos pelo símbolo %): 


fidataldate format:"Data: %d/%m/%Y Hora: YH: %M"} 


Para oferecer ao usuário a possibilidade de voltar à página anterior, criou-se um 
link que chama a função history.back do JavaScript: 


<a href="javascript history .backO">Voltar</a> 


Se você preferir, pode chamar diretamente a página inicial do sistema, a index. 
php. Nesse caso, apenas altere o link para: 


«a href="index.php'>Voltar</a> 


A figura 98 mostra o resultado da execução do programa mostra notícia. php, que ob- 
teve os dados sobre a notícia e os exibiu de acordo com o template mostra noticia.tpl. 


Clássico do futebol mundial na luta pelo ouro 
Data: 1 S/OBIZ003 Hora: 10:35 


Unm clássico do futebol mondial decide o torneio masculino dos Fogos Pan-Amencanos de Santo Dommgo Brasi e Argentna se enfrentaro, as 19h : À 
desta sexta-fara (20h de Brasilia). da 15, no Estádio Olimpico Juan Pablo Tarte. Se os confrontos entre os rrvais costumam ser quentes, à toi 
disputa Eca anda mais acurada quando está em jogo uma medalha de ouro O Brasi tentará o pentacampéonaro pan-amencane. O Brasil entra 
em campo com uma dúvida e uma aberação certa em relação ao bme que venceu é Minco por 1 a O na semifinal O zagueiro Irineu subshhu 
Adahos, expulso na semifinal 


Figura 9.8 — Exibindo a notícia completa. 
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Funções da Smarty para a criação de templates 


A seguir, serão listadas as funções, tanto as embutidas (built-in) como as persona- 
lizadas (custom), que a Smarty nos disponibiliza para a criação de templates. Para 
cada uma delas, são apresentadas sua sintaxe e descrição, de acordo com a versão 
2.60 da ferramenta. É recomendável que você consulte periodicamente o site oficial 
(http://smarty.php.net), para verificar se foram acrescentadas novas funções ou novos 
parâmetros para as funções já existentes. 


Embutidas 


Conforme citado anteriormente, as embutidas são as funções internas da Smarty 
que não podem ser modificadas. Veja-as a seguir. 


capture 


Permite o armazenamento da saída do template em uma variável, em vez de exi- 
bi-la na tela. Será capturado todo o conteúdo compreendido entre as tags {capture 
name="variavel"+ e {/capture}. 


Parâmetro Descrição 
name Nome do bloco capturado. 
assign Parâmetro opcional que permite definir uma variável do template para 


armazenar o bloco capturado. 


Para acessar o conteúdo capturado, também pode ser utilizada a variável especial 
$smarty, da seguinte forma: 


$smarty. capture. variavel 
Por exemplo: 

[capture name=teste) 
{include file="teste.tpl") 
f/capture) 


{$smarty. capture. teste) 


Se não for fornecido nenhum nome para a variável, ou seja, se você ocultar o 
atributo "name", será utilizado o valor "default". 


config load 


Carrega um arquivo de configuração, tornando suas variáveis disponíveis para o 
template. A seguir serão listados os parâmetros dessa função. 


Capítulo 9 = Utilizando modelos: seja “Smarty” 345 


Parâmetro Descrição 

file Nome do arquivo a ser carregado. 

section Nome da seção a ser carregada. 

scope Define o escopo das variáveis carregadas. Os valores possíveis são local, 
parent e global. 


Para carregar, por exemplo, as variáveis globais de um arquivo de configuração 
chamado index. conf, teremos: 


[config load file="index.conf") 


Caso o arquivo esteja dividido em seções, é possível carregar também as variáveis 
de seção, além das variáveis globais. Exemplo: 


[config load file="index.conf" section="Margens"} 
foreach, foreachelse 


Assim como a função section, a foreach também é usada para criar um laço para 
percorrer os elementos de um array associativo. Apesar de possuir uma sintaxe mais 
simples que a section, essa função tem a desvantagem de poder ser usada apenas 
com um array simples. 


Parâmetro Descrição 

from Array no qual o laço estará baseado. 

item Nome da variável que será associada ao elemento corrente do laço. 
key Nome da variável que irá armazenar a chave corrente. 

name Nome do laço foreach que permite acessar as propriedades do laço. 


O número de iterações do laço será determinado pelo número de elementos do 
array especificado no parâmetro from. Por exemplo, para exibir todos os valores de 
um array, teremos: 


{foreach from-farray item=corrente} 
0 vator corrente é: {$corrente}<br> 
{/foreach} 


A função foreach pode ser complementada pela foreacheise, que funciona de forma 
semelhante a else em um comando condicional. Porém, em vez de ser executado 
quando uma condição não for satisfeita, o bloco definido pela cláusula foreachelse 
será executado caso o array não possua valores. 
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include 


Inclui outros arquivos de template dentro do arquivo atual. As variáveis existentes no 
template atual também serão válidas para o template incluído. O único parâmetro 
obrigatório da função include é o file. 


Parâmetro Descrição 


file Nome do arquivo do template a ser incluído. 
assign Nome da variável que irá armazenar a saída do template. 


Lvar...] Permite passar variáveis ao template. As variáveis passadas serão válidas 
apenas dentro do escopo do arquivo incluído. 


Por exemplo: 


{include file="cabecalho.tpl"3 
{* corpo do template *3 
{include file="rodape.tpl") 


Em relação ao terceiro parâmetro da função, você pode criar seus próprios nomes 
de variáveis para passar ao template. Por exemplo: 


{include file="cabecalho.tpl" cor Fonte="E0000FF"3 
indude php 


Inclui um script PHP no template atual. O único parâmetro obrigatório da função 
include. php é o file. Lembre-se de que se o parâmetro de segurança estiver habilitado 
na classe Smarty ($security-=true), o script deverá estar localizado em um diretório 
seguro (Strusted dir). 


Parâmetro Descrição 
file Nome do arquivo PHP a ser incluído. 
once Indica se o arquivo PHP deve ser incluído mais de uma vez, caso sejam 
feitas múltiplas inclusões. 
assign Nome da variável que irá armazenar a saída do script PHP. 
Exemplo: 


tinclude php file="teste. php") 
insert 


Permite a inserção de chamadas para funções no template atual. Funciona de forma 
semelhante à função include, diferenciando-se por não utilizar o recurso de cache 
quando este estiver habilitado. Ou seja, a execução será feita a cada chamada para 
o template. 
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Parâmetro Descrição 

name Nome da função a ser inserida. 

assign Nome da variável que irá armazenar a saída do template. 

script Nome do script PHP a ser incluído antes da inserção da função. 
[var...] Variáveis a ser passadas como parâmetro para a função chamada. 


Por exemplo: 


{insert name=" retornaNome" codigo=#cod#} 


Nesse exemplo, deveria haver em seu programa PHP uma função chamada in- 
sert retornaNome(), que iria receber um código como parâmetro € deveria processá-lo, 
retomando algum resultado. Esse resultado seria colocado no lugar das tag insert 
no arquivo do template. 


O prefixo "insert." deve ser acrescentado ao nome de todas funções que você 
irá incluir em um template. 


if, elseif, else 


É o tradicional comando condicional if, cuja funcionalidade é idêntica à do PHP. 
Avalia uma condição e, se esta for verdadeira, executa um determinado bloco, senão 
avalia as condições especificadas nas cláusulas elseif (se existirem) e, por fim, se 
nenhuma condição for satisfeita, executa O bloco definido pela cláusula else. 


Por exemplo, para testar se a variável $none é igual à string "Juliano" ou à string "Andréia", 
poderemos utilizar o operador de comparação “eq” (equal), como mostrado a seguir: 
{if Snome eg “Juliano” or $nome eg “Andréia”? 
Seja bem vindo! 
{else} 
Você não tem autorização para acessar esta página. 
{/if} 
Entre os operadores suportados por essa função, temos: eq, ne,neq, gt, 1t, Ite, le, gte, 
ge, is even, is odd, is not even,is not odd,not,mod,div by,even by,odd by,==,!=, >, <, <= È >=. 


Se você preferir, pode usar a mesma sintaxe do PHP, utilizando operador de 
igualdade “==” e o operador OU como sendo “!|” Portanto, a sintaxe a seguir tam- 
bém será válida: 

[if fnome == "Juliano" || $nome == "Andréia" 


Um detalhe importante é que deve haver um espaço entre O operador e seus 
elementos, senão o comando não irá funcionar. Exemplo: 


Sintaxe correta: nome == "Juliano" 


Sintaxe errada:  $nome=="Juliano" 
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Idelim, rdelim 


Essas funções devem ser usadas caso você queira exibir os delimitadores (da es- 
querda e da direita) atualmente utilizados pela Smarty. É a única forma de exibi-los, 
pois caso sejam colocados diretamente no template, a Smarty irá interpretá-los em 
vez de mostrá-los na tela. Exemplo: 


O delimitador da esquerda é "[ldelim)" e o da direita é "{rdelim}". 


Caso não tenham sido alterados os delimitadores-padrão, esse template irá pro- 
duzir a seguinte saída: 


O delimitador da esquerda é "{" e o da direita é "y", 
literal 


Os dados localizados entre as tags {literal} e f/literal) serão colocados diretamente 
na saída do template, não sendo interpretados pela Smarty Essa função é de grande 
utilidade caso você queira incluir códigos de programação (como JavaScript) em 
suas páginas, já que estes contêm caracteres como “(“ e “}” que a Smarty tentaria 
interpretar. Veja um exemplo: 


{literal} 
<script tanguage=javascript> 
<l-/f 
function valida (nomeform) 
{ 
if Cnomeform.nome.value == "") 
{ alert ("\nPor favor digite o nome.'):; return false: } 
return true; 
E) 
(> 
</script> 
{/literal} 


php 


Permite a inclusão de códigos PHP diretamente no template. Nesse caso, a variável 
de configuração $php handling da classe Smarty deve estar configurada para executar 
códigos PHP Exemplo: 


{php} 
if (ŝtipo == "usuario") 
include("usuario. php"); 
else 
include("visitante.php"); 
{/php} 
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section, sectionelse 


Permite a criação de um laço, para percorrer todos os elementos de um array $o- 
mente dois parâmetros são obrigatórios: name € loop. 


Parâmetro Descrição 

name Nome da seção. Esse nome deverá ser usado entre colchetes para acessar 
os elementos do array. 

loop Variável que irá determinar o número de iterações. Normalmente é um 
array de valores. 

start Índice no qual o laço irá iniciar. Se for fornecido um valor negativo, o 
índice é calculado a partir do fim do array 

step Valor de incremento ou decremento da variável de controle da seção. 
Se for negativo, o array será acessado do fim para o início. 

max Define um número máximo de iterações para o laço. 

show Indica se a seção atual deve ser exibida ou não. 


O número de iterações do laço será determinado pelo número de elementos do 
array especificado no parâmetro loop. Por exemplo, para exibir todos os valores de 
um array chamado $valores, teremos: 


{section name=i loop=$valores} 
O valor corrente é {$valores[i] j <br> 
{section} 


No caso de arrays associativos, para exibir seu conteúdo, devemos especificar o 
nome do campo logo após o nome da seção, precedido por um ponto. Por exemplo: 


[section name=i loop=$dados} 
Nome: {$dados [1]. nomel<br> 
Endereço: [idados[i].endereco;<br> 
Fone: fSdados [1]. fonej<br> 
E-mail: f$dados[1] .email]<p> 
f/section) 


A função section pode ser complementada pela sectionelse, que funciona de forma 
semelhante a else em um comando condicional. Porém, em vez de ser executado 
quando uma condição não for satisfeita, o bloco definido pela cláusula sectionelse 
será executado caso o array não possua valores. Por exemplo: 


{section name=i Toop=Svalores+ 
{$valores[i]}<br> 
{sectionelse} 
O array $valores está vazio! 
f/section) 
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Outra característica a ser destacada no uso da função section é que a Smarty 
armazena as propriedades da seção corrente na variável especial $smarty. Essas pro- 
priedades podem ser acessadas da seguinte forma: 


[ismarty.section.secao. variavel) 


onde secao é o nome da seção corrente e variavel é o nome da propriedade cujo 
valor você quer obter, Os nomes das propriedades disponíveis são apresentados na 
tabela a seguir. 


Propriedade Descrição 


index Exibe o índice corrente do laço. Inicia em zero. 
index prev Exibe o índice anterior do laço. 
index next Exibe o próximo índice do laço. 


Parâmetro Descrição 

iteration Exibe o número da iteração corrente. 

first Contém o valor true caso a iteração corrente seja a primeira. 

last Contém o valor true caso a iteração corrente seja a última. 

rownum Exibe o índice corrente do laço. Inicia em 1. 

loop Pode ser usado dentro ou fora do laço para exibir o último índice 
utilizado na seção. 

show Contém o valor true, se a seção for exibida, ou false, caso contrário. 

total Exibe o número total de iterações que o laço irá conter. 


Por exemplo, se você criar uma seção chamada i, poderá acessar algumas de suas 
propriedades da seguinte forma: 


{fsmarty. section. i index) 
T$smarty.section.i.iteration) 
f$smarty.section.i.first) 
{$smarty. section. i. rownum} 


strip 


Pode ser utilizada em ambientes nos quais os espaços em branco e as quebras de 
linha afetam a saída HTML. O uso dessa função é interessante porque nos permite 
manter os templates legíveis, não sendo necessário juntar todas as tags para corrigir 
os problemas causados pelos espaços e quebras de linha, pois a própria função strip 
realiza essa tarefa. Exemplo: 


{strip} 
<table> 
<tr> 
<td> 
{$nome} 
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</td> 
</tr> 


</table> 
{/strip} 


Se o valor da variável $nome fosse "Juliano", o resultado seria o seguinte: 


«table><tr><td>Juliano</td></tr></table> 


Personalizadas 


As personalizadas são funções adicionais acrescentadas à Smarty por meio de 
plugins. Você pode modificá-las se desejar. Além disso, você pode acrescentar suas 
próprias funções personalizadas. 


assign 
Atribui valores às variáveis durante a execução de um template. 


Parâmetro Descrição 


var Nome da variável a qual será atribuída o valor. 
value Valor a ser atribuído à variável especificada. 
Exemplo: 


{assign var="nome" value="Juliano Niederauer") 
Meu nome é {$nome}. 


O resultado será: 


Meu nome é Juliano Niederauer. 
counter 


Cria um contador, permitindo que sejam definidas suas características por meio 
dos parâmetros apresentados a seguir. 


Parâmetro Descrição 

name Nome do contador. 

start Valor inicial do contador. O padrão é 1. 

skip Intervalo de variação do contador. O padrão é 1. 

direction Direção do contador, ou seja, se será crescente (up) ou decrescente (down). 
O padrão é up. 

print Indica se o valor do contador deve ser exibido. O padrão é true. 


assign Variável do template à qual será atribuído o valor do contador. 
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Veja um exemplo: 


{counter start=0 skip=3 print=false) 
fcounterk<br> 
Tcounterj<br> 
fcounterl<br> 


Ao exibir esse template, o resultado seria: 


3 
6 
9 


Se não tivesse sido utilizado o parâmetro print-false, seria exibido também o 
primeiro valor do contador, o zero. 


cycle 


Cria um ciclo em torno de um conjunto de valores, ou seja, acessa um valor do 
conjunto a cada chamada dessa função, retornando ao início após o acesso ao 
último elemento. 


Parâmetro Descrição 

name Nome do ciclo. 

values Valores do conjunto. Pode ser uma lista com os valores separados por 
vírgulas (ou pelo delimitador definido) ou um array. 

print Indica se o valor deve ser exibido ou não. O padrão é true, 

advançe Indica se deve ocorrer o avanço para o valor seguinte do conjunto. 

delimiter Permite definir o delimitador que irá separar os valores do conjunto. 


O padrão é a vírgula (). 
assign Variável do template à qual será atribuída a saída da função cycle. 


Essa função é bastante útil para exibir as linhas de uma tabela utilizando cores 
alternadas. Por exemplo, para que uma tabela tivesse linhas amarelas e verdes sendo 
exibidas de forma alternada, bastaria criar um laço e utilizar a função cycle para 
fazer a variação das cores: 


{section name=i Toop=$nomes) 

<tr bgcolor="fcycle values="4FFFFOO,HODFFOO" "> 
<td>{$nomes[i]}</td> 

</tr> 

{/section} 


Por exemplo, se o array $nomes possuísse os valores “Juliano”; “Pedro” e “Joaquim”, 
o resultado do template seria o seguinte: 


<tr bgcolor="&FFFFOQ"> 
«td>Juliano</td> 
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<ftr> 

<tr boacolor="400FFO0"> 
«<td>Pedro</td> 

</tr> 

«tr bgcotor="#FFFF00"> 
<td>Joaquim</td> 

</tr> 


debug 


Exibe o painel de depuração (debugging console), onde são mostradas todas as vari- 
áveis disponíveis dentro do escopo do template corrente. Essa função funciona de 
forma independente das configurações de depuração da classe Smarty. 


Parâmetro Descrição 

output Parâmetro opcional para definir o tipo de saída (html ou javascript). 
Exemplo: 
{debug} 


eval 


Avalia o conteúdo de uma variável como se fosse parte do template. Essa função 
é utilizada quando há referências a tags ou variáveis dentro do conteúdo de uma 


variável. 


Parâmetro Descrição 


val Variável ou string a ser analisada. 
assign Permite especificar uma variável do template para armazenar a saída da 
função eval. 


Por exemplo, suponha que temos um arquivo de configuração chamado index. 
conf, contendo as duas variáveis a seguir: 


titulo = Bem vindo ao site do {$nome}! 
anuncio = Conheça a obra [fnome obras 


Note que essas duas variáveis possuem tags da Smarty em seus conteúdos. Para 
que sejam interpretadas corretamente, devemos aplicar a função eval ao incluirmos 
essas variáveis no template, Por exemplo: 

(config load file="index. conf") 


{eval var=ftitulog) <br> 
[eval var=fanuncio?) 


Veja a seguir qual seria o resultado caso o valor da variável $noxe fosse “Juliano” 
e o da variável $nome obra fosse “PostgreSQL”: 
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Bem vindo ao site do Juliano! 
Conheça a obra PostgreSQL 


fetch 


Busca um arquivo e exibe seu conteúdo. O arquivo pode ser obtido no sistema de 
arquivos local ou pelos protocolos HTTP e FTP. 


Parâmetro Descrição 


file Nome do arquivo a ser buscado. Se começar com “http: //) a busca será 
feita no website especificado. Se começar com “ftp://” a busca será feita 
no servidor de FTP especificado. 


assign Permite especificar uma variável do template para armazenar o conteúdo 
do arquivo em vez de exibi-lo. 


Veja um exemplo: 


{fetch file="/ww/scripts/menu.js"} 
{fetch file="http://ww.algumsite. com. br/teste.txt"} 
{fetch file=-"ftp://ftp.algumsite. com. br/texto/texto, txt"} 


Caso o parâmetro de segurança da classe Smarty esteja habilitado, para o arquivo 
ser obtido localmente, deve estar localizado em um dos diretórios definidos como 
seguro ($secure_dir). 


html checkboxes 


Cria um grupo de caixas de seleção (checkboxes) com os valores fornecidos. Os 
textos e valores referentes a cada opção podem ser definidos de duas formas: com 
os parâmetros values e output ou simplesmente com o parâmetro options. 


Parâmetro Descrição 

name Nome da lista de caixas de seleção. 

values Array contendo os valores para as caixas de seleção. 

output Array contendo os textos a ser exibidos para as caixas de seleção. 

checked Valor referente ao elemento que será marcado inicialmente, 

options Pode ser usado no lugar dos parâmetros values e output. Deve ser um 
array contendo os valores e os textos para as caixas de seleção. 

separator Permite definir um separador para ser utilizado após a exibição de cada 
item. 

labels Indica se devem ser adicionadas tags <labe!> às caixas de seleção. 


Veremos a seguir um exemplo de definição dos textos e valores das caixas de 
seleção em um programa PHP, para posteriormente exibi-los no template por meio 
da função html. checkboxes. Acompanhe o programa apresentado a seguir: 
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index.php 


<?php 

require('Smarty.class.phpO; 

$smarty = new Smarty; 

$smarty->assign{'siglas', arrayC'SP's'RI', SC, RS); 

Ssmarty->assign('estados", array('São Paulo", 'Rio de Janeiro", 'Santa Catarina”, 
"Rio Grande do Sul ')); 

Ssmarty->assign("inicial!, 'RS'); 

Ssmarty->display(' checkbox. tpl'); 

7> 


Nesse programa, foram criados dois arrays, sendo um com os valores das caixas 
de seleção (SP, RJ, SC e RS) e outro com os textos referentes a cada um deles. Tam- 
bém se criou a variável $inicial, que indica a caixa de seleção que estará marcada 
inicialmente. Para exibir um conjunto de caixas de seleção baseadas nesses dados, 
bastaria criar um template chamado checkbox. tpt, contendo a seguinte linha: 


thtml checkboxes values=fsiglas output=festados checked=$inicial separator="<br />"} 


O resultado da execução do template seria o seguinte: 


<input type="checkbox" name="checkbox[]" value="SP" />São Paulo<br /> 

<input type="checkbox" name="checkbox[]" value="RJ" />Rio de Janeiro<br /> 

<input type="checkbox" name="checkbox[]" value="SC" />Santa Catarina<br /> 

<input type="checkbox" name="checkbox[]" value="RS” checked="checked" />Rio Grande do Sul<br /> 


Veja que como não se utilizou o parâmetro name da função html. checkboxes, assu- 
miu-se o valor-padrão, "checkbox". 


Dessa forma, os valores das caixas de seleção poderão ser acessados poste- 
riormente pelo programa que receberá os dados, por meio de um array chamado 


“checkbox”, 


O espaço e a barra existentes antes do fechamento da tag input foram inseridos 
para manter a compatibilidade com a linguagem XHTML. 


html image 


Cria uma tag HTML (<img>) para uma imagem, calculando suas dimensões caso 
não sejam fornecidas. 


Parâmetro Descrição 

file Nome da imagem, incluindo seu caminho se necessário. 

border Tamanho da borda em torno da imagem, 

height Altura na qual a imagem deve ser exibida. Se não for fornecida, será 


utilizada a altura atual da imagem, 
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Parâmetro Descrição (cont.) 

width Largura na qual a imagem deve ser exibida. Se não for fornecida, será 
utilizada a largura atual da imagem. 

basedir Diretório base que deve ser usado no caso de caminhos relativos. 

alt Descrição alternativa para a imagem. 

href Permite incluir um link na imagem. Deve conter o valor do atributo 


"href" da tag <img>, ou seja, o local para onde o usuário será direcionado 
ao clicar sobre a imagem. 


Por exemplo, para incluir no documento uma imagem chamada teste. jpg, teríamos 
a seguinte linha no template: 


{image file="teste.jpg"> 


Supondo que essa imagem tenha 40 pixels de largura e 60 pixels de altura, o 
resultado da exibição do template seria o seguinte: 


<img src="teste. jpg" border="0" width="40" height="60"> 


html options 


Cria um grupo de opções para um menu suspenso (dropdown) da HTML. Os tex- 
tos e valores referentes a cada opção podem ser definidos de duas formas: com os 
parâmetros values e output ou simplesmente com o parâmetro options. 


Parâmetro Descrição 

values Array contendo os valores para as opções do menu. 

output Array contendo os textos a ser exibidos para as opções do menu. 
selected Valor referente à opção que será selecionada inicialmente, 

options Pode ser usado no lugar dos parâmetros valves e output. Deve ser um 


array contendo os valores e os textos para as opções do menu, 


name Nome do grupo. Se for fornecido, serão geradas as tags «select 
name="nome. grupo"></select> em torno das opções, Caso contrário, so- 
mente as opções serão geradas. 


Como exemplo, podemos utilizar o mesmo programa index.php criado para a 
função html. checkboxes, que define as siglas e os nomes de alguns estados em dois 
arrays. Para exibir essas informações em forma de um menu suspenso, em vez de 
utilizar o template checkbox. tpl, vamos criar um template chamado menu. tpl. Esse tem- 
plate poderá ser criado de duas formas: 


fhtnl options values=ísiglas output=Sestados selected=Sinicial name=estado) 


ou 


«select name="estado”> 
fhtmrl options values=$siglas output=Sestados selected=Sinicial) 
<«/select> 
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Em ambos os casos, o resultado da exibição do template será o seguinte menu, 
com a opção “RS” já selecionada: 


<select name="estado"> 

<option label="São Paulo" value="SP">São Pautos/option> 

<option label="Rio de Janeiro" value="RJ">Rio de Janeiro</option> 

<option label="Santa Catarina” value="SC">Santa Catarina</option> 

<option Tabel="Rio Grande do Sul” value="RS" selected="selected">Rio Grande do Sul</option> 
</select> 


html radios 


Cria um grupo de botões radio com os dados fornecidos. Os textos e valores refe- 
rentes a cada botão podem ser definidos de duas formas: com os parâmetros values 
e output ou simplesmente com o parâmetro options. 


Parâmetro Descrição 

name Nome do grupo de botões radio. 

values Array contendo os valores para as caixas de seleção. 

output Array contendo os textos a ser exibidos para as caixas de seleção. 

checked Valor referente ao elemento que será marcado inicialmente. 

options Pode ser usado no lugar dos parâmetros values e output. Deve ser um 
array contendo os valores e os textos para as caixas de seleção. 

separator Permite definir um separador para ser utilizado após a exibição de cada 
item. 


Como exemplo, vamos utilizar o mesmo programa index.php criado para a função 
html checkboxes, que define as siglas e os nomes de alguns estados em dois arrays. 
Para exibir essas informações em forma de um grupo de botões radio, em vez de 
utilizar o template checkbox. tpl, vamos criar um template chamado radio. tpl, contendo 
a seguinte linha: 


fhtal radios values=fsiglas output=festados checked=$inicial name=estado separator="<br />"} 


O resultado da exibição desse template será um conjunto de botões radio, todos 
pertencentes a um grupo chamado “estado”: 


<input type="radio" name="estado” value="SP" />5ã0 Paulo<br /> 

<input type="radio" name="estado" value="R)" />Rio de Janeiro<br /> 

<input type="radio" name="estado” value="SC" />Santa Catarina<br /> 

<input type="radio" name="estado" value="R$" checked="checked” />Rio Grande do Sul<br /> 


O espaço e a barra existentes antes do fechamento da tag input foram inseridos 
para manter a compatibilidade com a linguagem XHTML. 
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html select date 


Cria menus suspensos (dropdown), permitindo a seleção de dia, mês e ano, de 
acordo com os parâmetros fornecidos. 


Parâmetro 
prefix 


time 


start year 


end year 


display days 
display months 
display years 


month format 


day format 


day value format 


month value format 


year as text 


reverse years 


field array 


day. size 
month size 
year size 
all.extra 
day extra 
month extra 
vear extra 
field order 


field separator 


Descrição 


Prefixo a ser acrescentado ao nome do grupo de opções. O 


padrão é “Date, ” 


Data e hora a ser utilizadas. O formato deve ser AAA A-MM-DD 
ou um timestamp. 


Primeiro ano a ser exibido no menu. Se for fornecido um valor 
negativo, será considerado relativo ao ano atual. O padrão é o 
ano corrente. 


Último ano a ser exibido no menu. Se for fornecido um valor 
negativo, será considerado relativo ao ano atual. O padrão é o 
ano corrente. 


Indica se o menu de dias deve ser exibido. O padrão é true. 
Indica se o menu de meses deve ser exibido. O padrão é true. 
Indica se o menu de anos deve ser exibido. O padrão é true. 


Define o formato no qual o mês deveser exibido (sintaxe sprintf). 
O padrão é %8. 


Define o formatono qual o dia deve ser exibido (sintaxe sprintf). 
O padrão é %02d. 


Define o formato no qual o número do dia deve ser exibido 
(sintaxe sprintf). O padrão é %d. 


Define o formato no qual o número do mês deve ser exibido 
(sintaxe sprintf). O padrão é Sm. 


Indica se o ano deve ser exibido como texto. O padrão é false. 


Indica se os anos devem ser exibidos na ordem reversa. O padrão 
é false. 


Permite definir o nome para um array para retornar os dados 
ao PHP nas formas array [Day], array [Month] e array [Year]. 


Permite definir um tamanho para a tag select dos dias. 
Permite definir um tamanho para a tag select dos meses. 
Permite definir um tamanho para a tag select dos anos. 
Permite adicionar atributos a todas as tags select. 
Permite adicionar atributos à tag select do dia. 

Permite adicionar atributos à tag select do mês. 

Permite adicionar atributos à tag select do ano. 


Ordem na qual os campos devem ser exibidos. O padrão é MDY 
(mês, dia, ano). 


Separador a ser utilizado entre as opções. O padrão é \n. 
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Os parâmetros dessa função são opcionais, mas normalmente você precisará uti- 
lizar alguns deles para formatar ou restringir os valores a ser exibidos. Por exemplo, 
para criar menus suspensos para a seleção de mês, dia e ano (nessa ordem), com o 
menu de anos contendo os últimos cinco anos, bastará acrescentar a seguinte linha 
no template: 


(html select date start. year=-5 field order=DMY3 


Como se especificou um valor negativo para o parâmetro start year, a Smarty O 
interpretará como sendo relativo ao ano atual. Com o parâmetro field order, indi- 
camos que primeiro deve ser exibido o menu de dias (D), depois o de meses (M) e, 
por último, o de anos (Y). Veja a seguir o resultado obtido na exibição do template: 


<select name="Date. Day"> 


<option Tabel="01" 
<option Tabal="02" 
«option Tabel="03" 
<option Tabel="04" 
<option label="05" 
<option Tabel="06" 
<option label="07" 
«option Tabel="08" 
<option Tahel="09" 
«option Tabel="10" 
«option label="11" 
<option label="12" 
<option Tabal="13" 
<option Tabel="14" 
<option label="15" 
<option label="16" 
«option Tabel="17" 
<option Tabel="18" 
<option Tabel="19" 
<option Tabel="20" 
<option label="21" 
<option label="22" 
<option label="23" 
<option label="24" 
<option Tabel="25" 
<option label="26" 
«option tabel="27" 
<option Tabel="28" 
<option label="29" 
<option Tabel="30" 
«option Tabel="31" 
«</select> 


value="1">01</0ption> 
value="2">02</option> 
value="3">03</option> 
value="4">04</option> 
value="5">05</option- 
value="6">06</option> 
value="7">07</option> 
value="8">08</option> 
value="9">09</option> 
value="10">10</option> 
value="11">11</option> 
value="12">12</option> 


value="13" selected="selected">13</option> 


value="14">14</option> 
value="15">15</option> 
value="16">16</option> 
value="17">17</option> 
value="18">18</option> 
value="19">19</option> 
value="20">20</option> 
value="21">21</option> 
value="22">22</option> 
value="23">23«/option> 
value="24">24</option> 
value="25">25</option> 
value="26">26</option> 
value="27">27</option> 
value="28">28</option> 
value="29">29</option> 
value="30">30</option> 
value="31">31</option> 


«select name="Date Month"> 


<option label="January" value="01">January</option> 
<option label="February" value="02">February</option> 
<option label="March” value="03">March</option> 
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<option tabel="April" 


<option 


«option label="June" 
<option Tabel="July” 
<option label="August" value="08" selected="selected">August</option> 


«option 
<option 
<option 
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value="04">April</option> 


Tabel="May" value="05">May</option> 


value="06">June</option> 
value="07">July</option> 


label="September" value="09">September</option> 
Tabel="October” value="10">0ctober</option> 
Tabel="November" value="11">November</option> 


«option Tabel="December”" value="12">December</option> 
</select> 
<select name="Date_Year"> 
<option label="1998" 
<option Tabel="1999º 
<option label="2000" 
<option label="2001" 
«option Tabel="2002" 
<option Tabel="2003" 


</select> 


value="1998">1998</option> 
value="1999">1999</option> 
value="2000">2000</option> 
value="2001">2001</option> 
value="2002">2002</option> 
value="2003" selected="selected">2003</option> 


Se em vez de exibir os nomes dos meses (que estão sendo mostrados em in- 


glês), você quisesse exibir o número dos meses, bastaria acrescentar o parâmetro 


month. format com o valor %m. Exemplo: 


html select time 


Thtml select date start year=-5 Field order=DMY month format=m>, 


Cria menus suspensos (dropdown), permitindo a seleção de hora, minuto, segundo 
e meridiano, de acordo com os parâmetros fornecidos, 


Parâmetro 


Descrição 


prefix 


time 

display hours 
display minutes 
display seconds 
display meridian 
use 24 hours 
minute interval 
second interval 
field array 


all extra 
hour extra 
minute extra 
second extra 


meridian extra 


Prefixo a ser acrescentado ao nome do grupo de opções. O 
padrão é “Time ”. 


Data e hora a ser utilizadas. Deve ser um timestamp. 

Indica se o menu de horas deve ser exibido. O padrão é true. 
Indica se o menu de minutos deve ser exibido. O padrão é true. 
Indica se o menu de segundos deve ser exibido. O padrão é true. 
Indica se o menu de meridianos deve ser exibido. O padrão é true. 
Indica se o formato de 24 horas deve ser usado. O padrão é true. 
Intervalo de variação dos minutos. O padrão é 1. 

Intervalo de variação dos segundos. O padrão é 1. 


Permite definir o nome de um array para armazenar os valores 
selecionados. 


Permite adicionar atributos a todas as tags select. 
Permite adicionar atributos à tag select das horas. 
Permite adicionar atributos à tag select dos minutos. 
Permite adicionar atributos à tag select dos segundos. 
Permite adicionar atributos à tag select dos meridianos. 


UEMA ia pe m a ret 
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Todos os parâmetros dessa função são opcionais, mas normalmente você pre- 
cisará utilizar alguns deles para formatar ou definir os valores a serem exibidos. 
Por exemplo, para criar menus suspensos para a seleção de hora e minuto apenas, 
bastará acrescentar a seguinte linha no template: 


(html select time display seconds=false 


Configurando o parâmetro display seconds para false, serão exibidos somente 
os menus de horas é minutos, e não o de segundos. Veja a seguir um exemplo de 
resultado obtido na exibição desse template. Considere os três pontos (..) como a 
continuação do conjunto de opções em questão: 


«select name="Time Hour"> 


<option tabel="00" 
<option label="01" 
«option label="02" 
<option Tabel="03" 


«option label="17" 
<option label="18" 
<option Tabel="19" 
<option label="20" 
«option label="21" 
<option Tabel="22" 
<option Tabel="23" 
</select> 


value="00">00</0ption> 
value="01">01</option> 
value="02">02</option> 
value="03">03</option> 


value="17">17</option> 
value="18">18</option> 


value="19" selected="selected">19</option> 


value="20">20</option> 
value="21">21</option> 
value="22">22</option> 
value="23">23</option> 


«select name="Time Minute”> 


<option Tabel="00" 
<option Tabel="01" 
<option label="02" 
<option Tabel="03" 
<option Tabel="04" 


<option Tabel="54º 
<option label="55" 
<option Tabel="56" 
<option label="57" 
<option Tabel="58" 
<option Tabel="59" 
</select> 


html table 


value="00">00</option> 
value="01">01</option> 
value="02">02</option> 
value="03">03</option> 
value="04">04</option> 


value="54">54</option> 
value="55">55</option> 


value="56" selected="selected">56</option> 


value="57">57</option> 
value="58">58</option> 
value="59">59</option> 


Cria uma tabela HTML a partir de um array. 


Parâmetro Descrição 

Joop Array com os dados que serão utilizados como conteúdo da tabela. 
cols Número de colunas da tabela. O padrão é 3. 

tableattr Atributos para a tag da tabela (<table>). O padrão é border=1. 
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Parâmetro Descrição (cont.) 


trattr Atributos para a tag de linha da tabela (<tr>). Pode ser uma string ou um 
array. No caso de array será criado um ciclo em torno de seus valores. 


td attr Atributos para a tag de célula da tabela (<td>). Pode ser uma string ou um 
array No caso de array será criado um ciclo em torno de seus valores. 


trailpad Valor a ser utilizado para preencher as células em branco na última 
linha da tabela. O padrão é um espaço (&nbsp;). 

hdir Direção na qual as linhas devem ser exibidas. Os valores possíveis são 
left (esquerda) e right (direita). O padrão é right. 


vdir Direção na qual as colunas devem ser exibidas. Os valores possíveis 
são up (cima) e down (baixo). O padrão é down. 


Veremos a seguir um exemplo de definição dos dados de uma tabela em um 
programa PHP, para posteriormente exibi-los no template por meio da função 
html table. Acompanhe o programa apresentado a seguir: 


index.php 


<?php 

require('Smarty.class.php'); 

Ssmarty = new Smarty; 
Ismarty->assign(' dados" ,array(1,2,3,4,5,6,7,8,9)); 
Ismarty->assignQ' atributo", 'bgcolor="4FFEFOO"'): 
Ssmarty->display("index,tp1'D; 

?> 


Nesse programa, criaram-se um array com valores de 1 a 9 e a variável Satributo 
para definir a cor de fundo (bgcolor) das linhas da tabela, Para exibir uma tabela 
baseada nesses dados, bastará criar um template chamado index.tpl, contendo a 
seguinte linha: 


{html table Toop=$dados cols=4 tr attr=Satributo) 


Nesse caso, o array $dados seria percorrido e seus valores seriam colocados nas 
células da tabela. Cada quatro valores consecutivos desse array representariam uma 
linha, visto que definimos o valor 4 para o número de colunas. As linhas seriam 
exibidas com a cor de fundo amarela, conforme definimos na variável Satributo. O 
resultado da execução do template seria o seguinte: 


«table border="1"> 

«tr bgcolor="#FFFF00"> 
«td>1</td> 

<td>2</td> 

<td>3</td> 

<td>4</td> 

«ftr> 

«tr bgcolor="&FFFFOQ"> 


| 
| 
| 
| 
| 
| 
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<td>5</td> 
<td>6</td> 
<td>7</td> 
<td>8</td> 
</tr> 

«tr bgcolor="#FFFF00"> 
<td>9</td> 
<td>ånbsp; </td> 
<td>ênbsp; </td> 
<td>ênbsp; </td> 
«</tr> 

</table> 


Note que como as três últimas células ficaram em branco, a Smarty as preencheu 
com o valor-padrão do parâmetro trailpad, que é um espaço em branco (ênbsp;). 


math 


Permite a inserção de equações matemáticas no template. Os operadores que podem 
ser usados são +, -, /, *, abs, ceil, cos, exp, floor, 109, 10g10, max, min, pi, pow, rand, round, sin, 
sqrt, srans e tan. Os elementos da equação podem ser variáveis do template (numéri- 
cas) ou valores estáticos. Por questões de desempenho, é mais recomendável realizar 
cálculos no próprio programa PHP em vez de usar a função math nos templates. 


Parâmetro Descrição 

equation Equação a ser avaliada. 

format Define como o resultado deve ser formatado (sintaxe sprintf). 

var Valor da variável da equação. 

assign Permite especificar uma variável do template para armazenar a saída 


da função math. 
Evar...] Variáveis a ser passadas como parâmetro para a equação. 


Veja um exemplo: 
{math equation="(a + b) / 3" a=$base b=Saltura) 


Se as variáveis $base e $altura tivessem, por exemplo, os valores 10 e 8,0 resultado 
exibido seria: 


6 
mailto 


Cria automaticamente links para endereços de e-mail (mailto). Permite ainda aplicar 
uma codificação, para evitar que o e-mail seja encontrado por softwares chamados 
web spiders. Esses softwares buscam e-mails na web para posteriormente lhes enviar 
propagandas. 
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Parâmetro 
adress 
text 


encode 


cC 


bcc 


subject 
newsgroups 


followupto 


extra 
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Descrição 


Endereço de e-mail para o qual o link será criado. 


Texto a ser exibido para o link. O padrão é o próprio endereço de e- 
mail. 


Codificação a ser aplicada no e-mail. Os valores possíveis são none, hex 
ou javascript. 


Endereços para os quais deve ser enviada uma cópia (carbon copy) do 
e-mail. Use vírgula para separá-los, 


Endereços para os quais deve ser enviada uma cópia oculta (blind 
carbon copy) do e-mail, Use vírgula para separá-los. 


Assunto do e-mail. 


Grupos de notícias (newsgroups) para os quais o e-mail será enviado. 
Use vírgula para separar os valores. 


Endereços para os quais o e-mail deve ser encaminhado. Use vírgula 
para separá-los. 


Qualquer informação adicional a ser passada para o link. 


Veja alguns exemplos: 


{mailto address="julianoâniaderauer. com.br" 
{mailto address="julianoêniederauer. com.br" subject="Olá Juliano!" 
{mailto address="julianoêniederauer. com.br” text="Chique aqui para enviar e-mail!"3 


As duas primeiras linhas desse template irão usar o próprio endereço julianoa 
miederauer com.br como texto do link. Na terceira, o texto foi definido com o parâmetro 
text da função mailto. Ao exibirmos esse template, teríamos o seguinte resultado: 


<a href="mailto: julianoQniederauer. com.br” >julianoêniederauer. com.br</a> 
<a href="mailto: julianoQniederauer. com.br” >Clique aqui para enviar um e-maili</a> 
<a href="mailto: julianoQniederauer. com. br?subject-01%E1%20]Jutiano%21" >julianofniederaver.com.br</a> 


popup. init 


Permite a integração com uma biblioteca JavaScript chamada overLib, usada para 
a criação de janelas popup. Essa biblioteca está disponível em http://www.bosrup. 
com/web/overlib/. À chamada para a biblioteca deve ser incluída no início de todas as 
páginas que irão utilizar a função popup. Exemplo: 


tpopupiinit src="/javascript/overlib.js"F 


popup 


Utiliza as funções JavaScript da biblioteca overLib para criar janelas popup. 
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Evento que irá disparar a janela. Pode assumir os valores onMouselver 


Indica se a janela será do tipo sticky permanecendo aberta mesmo 


Movimenta a janela para a esquerda da posição do mouse. 
Movimenta a janela para a direita da posição do mouse. 


Permite utilizar uma figura em vez de uma cor como fundo da 
Permite utilizar uma figura em vez de uma cor como borda da 


Permite configurar o texto “Close” (fechar) para a janela. 
g p ] 


Usa o texto do título da janela como texto da barra de status. 


Parâmetro Descrição 
text Texto ou código HTML a ser exibido na janela. 
trigger 

ou onClick. O padrão é onouselver. 
sticky 

que o mouse não esteja mais posicionado sobre o link. 
caption Define o título da janela. 
fgcolor Cor a ser aplicada dentro da caixa popup. 
bgcolor Cor a ser aplicada na borda da caixa popup. 
textcolor Cor a ser aplicada no texto dentro da caixa popup. 
capcolor Cor a ser aplicada no título da caixa popup. 
closecolor Cor a ser aplicada no texto “Close” (fechar). 
textfont Fonte a ser utilizada no texto principal. 
captionfont Fonte a ser utilizada no título da janela. 
closefont Fonte a ser utilizada no texto “Close” (fechar). 
textsize Tamanho da fonte para o texto principal, 
captionsize Tamanho da fonte para o título da janela. 
closesize Tamanho da fonte para o texto “Close” (fechar). 
width Largura da janela. 
height Altura da janela. 
left 
right 
center Movimenta a janela para a posição do mouse. 
above Movimenta a janela para cima da posição do mouse. 
below Movimenta a janela para baixo da posição do mouse. 
border Espessura da borda da janela. 
offsetx Distância horizontal da janela até o ponteiro. 
offsety Distância vertical da janela até o ponteiro. 
fgbackground 

janela. 
bgbackground 

janela. 
closetext 
noclose Indica que não deve ser exibido o texto “Close” 
status Texto a ser exibido na barra de status do navegador. 
autostatus Usa o texto da janela como texto da barra de status, 
autostatuscap 
inarray 


Indica que a overLib deve ler o texto a partir do array 01. text dessa 
biblioteca. 
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Parâmetro Descrição (cont.) 

caparray Indica que a overLib deve ler o título a partir do array 01. caps dessa 
biblioteca. 

capicon Imagem a ser exibida antes do título da janela. 

snapx Ajusta a posição horizontal da janela, 

snapy Ajusta a posição vertical da janela. 

fixx Fixa a posição horizontal da janela. 

fixy Fixa a posição vertical da janela. 

background Permite utilizar uma imagem como fundo, em vez da borda da 
tabela, 

padx Adiciona espaços horizontais à imagem de fundo, para inserção de 
texto. 

pady Adiciona espaços verticais à imagem de fundo, para inserção de 
texto. 

fullhtmi Permite controlar o código HTML sobre a figura utilizada como 
fundo da janela. 

frame Usa um frame diferente para a janela. 

timeout Define uma função JavaScript a ser chamada. O valor retornado 
será exibido como texto na janela. 

delay Tempo (em milissegundos) a ser aguardado antes da exibição da 
janela. 

hauto Determina de forma automática se a janela deve ser posicionada à 
esquerda ou à direita da posição do mouse. 

vauto Determina de forma automática se a janela deve ser posicionada 


Veja um exemplo: 


acima ou abaixo da posição do mouse. 


f* inicia a biblioteca overLib +} 

Tpopup init src="/javascript/overlib.js"t 

{* cria um link com uma janela popup *} 

<a href="index.html" {popup text="Cligue nesse link para retornar"J>Voltar</a> 


Ao exibir esse template, será apresentado um link para uma página chamada 


index.html, com o texto “Voltar”. Ao passar o mouse sobre o link (o evento-padrão 
é onMouselver), será exibida uma janela popup com o texto “Clique nesse link para 


retornar”, 


textformat 


Formata textos, eliminando espaços e caracteres especiais, definindo limites para 


as linhas de um parágrafo e realizando a endentação das linhas. O texto a ser for- 
matado deve set inserido entre as tags ftextformat) e {/ textformat). 
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Parâmetro Descrição 
style Nome de um estilo predefinido. 
indent Número de caracteres a ser endentados a cada linha. 


indent first Número de caracteres a ser endentados na primeira linha. 
indent char Caractere a ser usado para fazer a endentação. O padrão é um espaço. 


wrap Número de caracteres que cada linha deverá possuir. 

wrap char Caractere ou string a ser acrescentado ao final de uma linha. O padrão 
é\n. 

wrap. cut indica se o término da linha pode ocorrer no caractere exato da posição 


indicada (true) ou se pode ocorrer somente ao final de uma palavra 
(false). O padrão é false, 


assign Variável do template que irá receber a saída da função textformat. 


Veja um exemplo: 


{textformat wrap=50 indent=2} 

Grêmio campeão do mundo em 1983. Grêmio bicampeão da américa em 1995. Grêmio tetracampeão 
da copa do brasil em 2001. 

[/textformat) 


Com o parâmetro wrap, definimos que cada linha poderá ter no máximo 50 
caracteres e, como o valor-padrão de wrap. cut é false, se a última palavra da linha 
for ultrapassar a posição 50, será passada para a linha seguinte. Com o parâmetro 
indent, definimos que o texto deve ser endentado a duas posições do início da linha. 
O resultado da exibição desse template será: 


Grêmio campeão do mundo em 1983, Grêmio 
bicampeão da américa em 1995. Grêmio 
tetracampeão da copa do brasil em 2001. 


Métodos da classe Smarty para o PHP 


A seguir, serão listados os métodos que podem ser chamados por um objeto da 
classe Smarty em um programa PHP. Para cada um deles, são apresentadas sua 
sintaxe e descrição. Consulte periodicamente o site da ferramenta (http: //smarty. 
php.net), para verificar se foram acrescentados novos métodos ou novos parâmetros 
para os métodos já existentes. 


append 


Adiciona um elemento a um determinado array Se for fornecida uma string, 
será convertida para array antes de o elemento ser adicionado. 
void append(misto var) 


void append(string nome variável, misto var) 
void append(string nome variável, misto var, boolean unir) 
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append by ref 


Adiciona valores aos templates por referência. Dessa forma, se for adicionada uma 
variável e esta sofrer alterações, o valor adicionado também será alterado. 


void append.by ref(string nome variável, misto var) 
void append by ref(string nome variável, misto var, boolean unir) 
assign 


Atribui valores às variáveis que serão utilizadas nos templates. Podem ser 
fornecidos diretamente pares nome/valor ou, então, arrays associativos 
contendo esses pares. 


void assign(misto var) 
void assign(string nome variável, misto var) 
assign by ref 


Atribui valores às variáveis dos templates por referência. Dessa forma, ao 
atribuir uma variável e logo após alterar seu valor, o valor atribuído também 
será alterado. 


void assign by ref(string nome variável, misto var) 


clear all assign 
Elimina todos os valores atribuídos às variáveis. 


void clear all assignt) 


clear all cache 


Elimina os arquivos existentes na cache de templates da Smarty Permite 
ainda definir um tempo mínimo de existência para os arquivos que serão 
excluídos. 


void clear all cache(int tempo expiração) 


clear assign 


Elimina o valor atribuído a uma variável. Pode ser especificado uma variável 
ou um array. 


void clear assignéstring var) 


clear cache 


Elimina a cache para um determinado template. Se houver mais de um arquivo 
de cache para um mesmo template, permite definir o identificador daquele 
que deve ser excluído. 


void clear cache(string template [, string id cache [, string id compilação 
[, int tempo expiração) 
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clear compiled tpl 


Elimina o arquivo compilado de um determinado template, Caso nenhum 
arquivo seja especificado, elimina todos os arquivos compilados. 


void clear compiled tplóstring arquivo tpl) 


clear config 


Elimina uma determinada variável de configuração. Caso nenhuma variável 
seja especificada, todas as variáveis de configurações serão eliminadas. 


void clear config([string var]) 


config load 


Carrega um arquivo de configuração, disponibilizando todos seus dados ao 
template. 


void config_load{string arquivo [, string seção]) 


display 
Exibe um template. Opcionalmente, pode-se indicar o identificador de 
compilação, nos casos em que há mais de uma versão compilada para o 
mesmo template. 


void display(string template [, string id cache [, string id_compitação]]) 


fetch 


Retorna a saída de um template em vez de exibi-lo. Os parâmetros são os 
mesmos do método display. 


string fetchístring template [, string idicache [, string id compilaçãol]) 


get config vats 


Retorna o valor de uma determinada variável de configuração. Se nenhuma 
variável for especificada, retorna um array com o valor de todas disponíveis. 


array get config vars([string nome variável]) 


get registered object 
Retorna uma referência a um determinado objeto registrado. 


array get registered object(string nome objeto) 


get template vars 


Retorna o valor de uma determinada variável do template. Se nenhuma variável 
for especificada, retorna um array com o valor de todas disponíveis. 


array get template vars([string nome variável) 
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is cached 


Usado apenas quando a funcionalidade de cache estiver habilitada. Retorna 
true caso exista um arquivo de cache válido para o template especificado. 


void is cached(string template, [string id cache]) 


load filter 


Permite carregar um filtro através de um plugin. O tipo do filtro pode ser pre, 
post ou output. 


void load filterCstring tipo, string nome) 


register block 


Registra dinamicamente funções de bloco, que poderão ser utilizadas nos 
templates. O segundo parâmetro corresponde ao nome da função que contém 
a implementação. 


void register block(string nome, string implementação, bool hab cache, array ou null atr cache) 


register compiler function 


Registra dinamicamente funções de compilação. O segundo parâmetro 
corresponde ao nome da função que contém a implementação. 


void register compiler function(string nome, string implementação, bool hab cache) 


register function 


Registra dinamicamente funções que poderão ser utilizadas nos templates. 
O segundo parâmetro corresponde ao nome da função que contém a 
implementação. 


void register function(string nome, string implementação, bool hab cache, array ou null atr cache) 


register modifier 


Registra dinamicamente modificadores que poderão ser aplicados aos 
elementos dos templates. O segundo parâmetro corresponde ao nome da 
função que contém a implementação. 


void register modifier(string nome, string implementação) 


register object 
Registra um objeto para ser utilizado nos templates. 


void register object(string nome objeto, object Sobjeto, 
array métoddos. propriedades períritidas, boolean formato, array métodos bloco) 
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register outputfilter 


Registra dinamicamente funções de filtros de saída, que poderão operar sobre 
um template antes de sua exibição. 


void register_outputfilter(string nome. Função) 


register postfilter 
Registra dinamicamente filtros que poderão ser aplicados sobre um template 
após a sua compilação. 


void register postfilter(string nome Função) 


register prefilter 


Registra dinamicamente filtros que poderão ser aplicados sobre um template 
antes de sua compilação. 


void register prefilter(string nome função) 


register resource 


Registra dinamicamente plug-ins de recursos que poderão ser utilizados pela 
Smarty. O segundo parâmetro corresponde aos nomes das funções PHP que 
contêm as implementações. 


void register resource(string nome, array func recurso) 


trigger error 


Define uma mensagem de erro a ser exibida pela Smarty Permite ainda definir 
o tipo de erro (o padrão é E USER WARNING). 


void trigger error(string msg erro, [int nivel) 


template exists 
Verifica se um determinado template existe. 


bool template exists(string template) 


unregister block 
Elimina o registro de uma função de bloco registrada por register block. 


void unregister block(string nome) 


unregister compiler function 


Elimina o registro de uma função de compilação registrada por register. 
compiter function. 


void unregister compiler function(string nome) 
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unregister function 
Elimina o registro de uma função registrada por register. function. 


void unregister function(string nome) 


unregister modifier 
Elimina o registro de um modificador registrado por register madifier, 


void unregister modifier(string nome) 


unregister object 
Elimina o registro de um objeto registrado por register object. 


void unregister objectístring nome objeto) 


unregister outputfilter 
Elimina o registro de um filtro de saída registrado por register outputhlter. 


void unregister outputfilteróstring nome função) 


unregister postilter 


Elimina o registro de um filtro de pós-compilação registrado por register. 
postfilter., 


void unregister postfilteróstring nome função) 


unregister prefilter 


Elimina o registro de um filtro de pré-compilação registrado por register. 
prefilter, 


void unregister prefilter(string nome função) 


unregister resource 


Elimina o registro de um plug-in de recursos registrado por register. 
resource, 


void unregister resource(string none) 


Capítulo 10 


Acesse um banco de dados! Não importa qual... 


Neste capítulo, você irá entender qual a utilidade das bibliotecas de abstração de 
banco de dados existentes para o PHP além de aprender a criar aplicações utilizando 
algumas delas. Serão apresentados todos os passos necessários para operar sobre um 
banco de dados, como a abertura da conexão, execução de consultas SQL, obtenção 
dos resultados e encerramento da conexão. E ainda, para facilitar o entendimento, 
serão apresentados exemplos de uso para cada biblioteca. 


Por que usar abstração de banco de dados? 


A abstração de banco de dados é um recurso extremamente útil, pois permite que 
você torne suas aplicações portáveis entre diferentes SGBDs (Sistemas de Gerência 
de Bancos de Dados). Esse recurso é implementado por bibliotecas que fazem a in- 
teração entre seus programas PHP e seu sistema gerenciador de bancos de dados. 


Por essa razão, essas bibliotecas são chamadas de Database Abstraction Layer, 
ou seja, Camada de Abstração de Banco de Dados, pois trata-se de uma camada 
intermediária entre a aplicação e o banco de dados. Na programação convencional, 
sem abstração, teriamos: 


Programa PHP 


Banco 


de 
dados 


Figura 10.1 — Acesso a banco de dados sem abstração. 
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Utilizando uma biblioteca de abstração, o programa PHP iria conter uma 
chamada para essa biblioteca, que, por sua vez, iria enviar a requisição ao sistema 
gerenciador de bancos de dados, como ilustra a figura 10.2. 


Programa PHP 


ABSTRAÇÃO 


Banco 


de 
dados 


Figura 10.2 — Acesso a banco de dados com abstração. 


Você pode estar se perguntando: “Mas qual é a real vantagem de acrescentar essa 
camada entre o programa e o banco de dados”? O acesso não ficará mais lento do 
que o normal? É claro que, como existe esse passo intermediário, o acesso ficará um 
pouco mais lento do que se você estivesse usando as funções nativas de seu SGBD, 
Porém, a grande vantagem é que seus programas irão se tornar portáveis, pois não 
estarão “engessados” para uso com um único SGBD, O mesmo programa poderá ser 
utilizado no MySQL, PostgreSQL, InterBase, Oracle e todos os outros suportados 
pela biblioteca que você estiver utilizando, como ilustra a figura 103. 


ty 


Figura 10.3 — Interação da biblioteca de abstração com os SGBDs. 


Portanto, não haverá problemas caso você tenha que mover seu website para um 
servidor que possua outro SGBD instalado ou se você estiver trabalhando como 


programador em uma empresa e houver mudanças desse tipo na especificação de 
um projeto. 
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Isso é bastante comum de acontecer no mundo da tecnologia. Inicialmente, 
considera-se uma determinada plataforma como sendo a ideal para um projeto, 
mas com o tempo percebe-se que existiam alternativas melhores. Se você estiver 
programando sem usar abstração de banco de dados e houver necessidade de trocar 
de SGBD, todo o seu código deverá ser revisado e as funções de acesso ao banco de 
dados deverão ser adaptadas para o novo SGBD. 


Se você estiver usando uma biblioteca de abstração de banco de dados, isso não 
será necessário, pois essas bibliotecas traduzem os comandos fornecidos para os 
comandos nativos dos SGBDs. Por exemplo, imagine que a biblioteca de abstração 
tem funções chamadas Connect e Query, para realizar conexão e consultas ao banco 
de dados, respectivamente. Então: 


* se você estiver usando o MySQL, Connect será traduzido para mysql. connect; 


* se você estiver usando o PostgreSQL, Connect será traduzido para pg. 
connect; 


- se você estiver usando o InterBase, Connect será traduzido para ibase. 
connect; 


-e assim por diante, para todos bancos de dados suportados pela biblioteca. 


Por exemplo, se seu servidor tiver o MySQL instalado e houver necessidade de 
transferir seu site para um servidor que tem o PostgreSQL, em vez de alterar todo o 
código de acesso ao banco de dados, bastará você informar à biblioteca de abstração 
que irá usar o PostgreSQL. Assim, a biblioteca passará a usar os comandos desse 
SGBD, sem que você precise alterar seu código. 


Bibliotecas disponíveis 


Existem muitas bibliotecas de abstração de banco de dados disponíveis para o PHP. 
Como exemplo, podem ser citadas dbx, PEAR::DB, PEAR::MDB, PEAR:MDB?, 
PHPLIB, Metabase e ADODB. Neste livro, será apresentada a DBX, além da PEAR:: 
DB, que vem sendo utilizada em grande escala pelos desenvolvedores. 


Extensão dbx 


Em versões mais antigas do PHP, esta extensão já vinha embutida. Atualmente, po- 
rém, está disponível na biblioteca de extensões PECL (http: //pecl.php.net) e precisa 
ser instalada separadamente. 
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O “db” significa Database e o “X” representa qualquer um dos bancos de dados 
suportados. A dbx possui poucos comandos, é extremamente simples e fácil de usar, 
porém um pouco limitada. Apesar disso, pode ser usada na maioria dos programas 
que requer a execução de operações simples sobre um banco de dados. 


Suporta diversos SGBDs, como, por exemplo, MySQL, PostgreSQL, SQL Server, 
ODBC, Sybase, Oracle e inclusive o SQLite, disponível a partir da versão 5 do PHP 


Às classes PEAR::DB e PEAR::MDB2 


São classes externas que implementam abstração de banco de dados e estão dis- 
poníveis para download no PEAR (repositório de extensões e aplicações do PHP), 
no endereço http://pear.php.net. 


A classe PEAR::DB é a mais conhecida e utilizada. Apesar se ser mais complexa 
que a extensão dbx do PHP, oferece grande quantidade de recursos que não estão 
disponíveis nessa extensão. Também suporta uma grande variedade de SGBDs, 
como, por exemplo, dBase, InterBase, Informix, mSQL, MSSQL, MySQL, ODBC, 
PostgreSQL, SQLite, Sybase e Oracle, 


A classe PEAR::MDB2 surgiu posteriormente, consistindo na união da classe 
PEAR::DB com uma outra biblioteca de abstração chamada Metabase. Portanto, 
possui alguns recursos adicionais em relação à classe DB. 


Em termos de programação, há poucas diferenças entre as classes DB e MDB. Por 
essa razão, os exemplos apresentados neste capítulo estarão baseados na PEAR::DB. 
Porém, ao final do capítulo veremos como alterar um dos exemplos para utilizar a 
PEAR::MDB2. 


Comparação das bibliotecas 


À seguir, será apresentado um quadro comparativo entre a extensão .dbx do PHP e 
a classe PEAR: :DB. À comparação baseia-se nas características de velocidade, comple- 
xidade e recursos oferecidos. 


Utilizando a extensão dbx 


A partir de agora, veremos como funciona a extensão .dbx. Será dada uma explica- 
ção passo a passo das principais operações que podemos realizar sobre um banco 


de dados. 


| 
| 
| 
| 
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Instalação 


Em algumas versões antigas do PHP, a extensão .dbx já vem embutida. Nesses casos, 
em servidores Windows, precisamos apenas habilitá-la no arquivo de configuração 
php.ini, por meio da seguinte linha: 


extension=php. dbx. dll 


Para servidores Unix/Linux, é necessário compilar o PHP com suporte a essa 
extensão (com o parâmetro -enable-dbx). 


Nas versões mais recentes do PHP, a dbx precisa ser instalada separadamente. 
Para isso, é necesário fazer o download dos arquivos-fonte da biblioteca em: 


http://pecl.php.net/package/dbx 
Veja instruções de instalação no site pessoal do autor, em: 


http://www. niederauer. com, br/livros/phpavancado/dbx. html 


Verifique também, na documentação de sua versão do PHP, quais são os SGBDs 
suportados pela dbx. Atualmente, essa extensão suporta Os SGBDs mais utilizados 
do mercado, como MySQL, PostgreSQL, SQL Server, Oracle, entre outros. 


Conectando ao banco de dados 


Para abrir uma conexão com um banco de dados, deve-se utilizar a função dbx. con- 
nect, que possui a seguinte sintaxe: 


objeto dbx connect (misto módulo, string servidor, string banco, string usuário, 
string senha [, int persistentel) 


Parâmetro Descrição 

móduto Pode ser uma string ou uma constante, que indica o módulo do SGBD 
que será utilizado. 

servidor Endereço do servidor no qual está localizado o banco de dados. 

banco Nome do banco de dados a ser acessado. 

usuário Nome de usuário a ser utilizado para a abertura da conexão. 

senha Senha a ser utilizada para a abertura da conexão. 


persistente Indica se deve ser estabelecida uma conexão persistente. Nesse caso, 
pode-se configurá-lo com a constante DBX PERSISTENT. 


Configure o parâmetro móduto de acordo com o SGBD que você irá utilizar. Esse valor 
pode ser definido com uma string ou uma constante predefinida. Por exemplo: 
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= DBX MYSQL ou “mysql”, 
= DBX ODBC ou “odbc” 
" DEX PGSOL ou “pgsql”, 
= DBXMSSQL ou “mssql”? 
= DBX FBSQL ou “fbsgl” 
= DBX SYBASECT ou “sybase ct” 
=  DBX OCI8 ou “ocik” 
* DEXSQLITE ou “sqlite” 


Por exemplo, se você estivesse utilizando o MySQL, poderia acessá-lo de duas 
formas: 


fcon = dbx connect ("mysql", "localhost", "banco", "usuario", "senha"; 
ou 
fcon = dbx connect (DEX MYSQL, "localhost", "banco", “usuario”, "senha"); 


Então, se você passasse seu site para um servidor que utiliza um banco de dados 
PostgreSQL, bastaria alterar o nome do módulo a ser acessado. Por exemplo: 


$con = dbx connect ("pasgl", "localhost", "banco", "usuario", "senha"); 
ou 
$con = dbx connect (DBX PGSQL, “localhost”, "banco", "usuario", "senha"): 


Lembre-se de que a dbx faz apenas a interface entre seus programas e o banco 
de dados, e por essa razão o módulo do SGBD deve estar ativo. 


A função dbx comect retorna um objeto contendo as seguintes propriedades: 


Propriedade Descrição 


database Nome do banco de dados corrente, 


handle É o identificador do banco de dados corrente que será passado como 
parâmetro para as funções que operam sobre ele. 


module É usado internamente pela dbx. Contém o número do módulo em uso. 
Caso você queira interromper a execução do programa se a conexão não for 
estabelecida com sucesso, poderá usar o comando die do PHP: 


$con = dbx connect (“mysgl", "localhost", "banco", "usuario", "senha") 
or die (“Não foi possivel conectar"); 
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Executando consultas SQL 


Após abrir uma conexão com um banco de dados, podemos utilizar a função dbx query 
para realizar consultas sobre ele, A sintaxe dessa função é a seguinte: 


objeto dbx query (objeto id.conexão, string comando sat [, long flags]) 


Parâmetro Descrição 


id conexão Identificador da conexão, retornado pela função dbx connect, 
comando. sql Comando SQL a ser executado. 


flags Pode ser uma ou mais constantes que irão definir como os dados serão 
retornados. 


Esse parâmetro flags pode ser uma das constantes apresentadas a seguir, ou uma 
combinação delas utilizando como separador uma barra vertical (“|”). 


Constante Descrição 


D8X RESULT. INDEX É habilitado por padrão. Indica que o objeto retornado tem 
sua propriedade de dados (data) definida como um array de 
duas dimensões, indexadas numericamente. Por exemplo, 
em dataf1] [2], 1 representa a linha e 2, a coluna, e as linhas 
e colunas iniciam em 0. 


DBX RESULT. INFO Indica que devem ser retornadas informações sobre as colunas, 
como, por exemplo, seus nomes e tipos. 

DBX RESULT. ASSOC Indica que os dados retornados poderão ser acessados com 
o uso do nome da coluna como chave do array. Por exemplo, 
se a primeira coluna retornada fosse a “nome” em vez de 
acessar o primeiro registro usando data[0) [0], poderia ser 
usado data[0]['none']. 

DBX COLNAMES UNCHANGED Não modifica os nomes das colunas resultantes. 

DBX COLNAMES UPPERCASE Os nomes das colunas resultantes serão convertidos para 
letras maiúsculas. 

DBX COLNAMES. LOMERCASE Os nomes das colunas resultantes serão convertidos para 
letras minúsculas. 


A função dbx query retorna um objeto contendo as seguintes propriedades: 


Propriedade Descrição 


handle Identificador do banco de dados corrente. 


colse rows Contém o número de colunas e linhas, respectivamente, do resultado 
da consulta. 


info Array de duas dimensões contendo informações sobre as colunas. É 
retornado somente quando for habilitada a flag DBX RESULT INFO ou a 
DBX RESULT ASSOC. 

data Contém os dados resultantes da consulta. Se for habilitada a flag 


DBX RESULT ASSOC, o nome das colunas poderá ser usado como chave 
(exemplo: $res->data[0] ["nome"]}. 
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Veja um exemplo de uso da função dbx query, após a abertura de uma conexão 
com o banco de dados: 


<?php 


$con = dbx comect ("mysql", $servidor, fbanco, fusuario, $senha); 
$res = dbx query ($con, "select * from tabela"); 


?> 


À seguir, veremos como tratar os dados resultantes da consulta. 


Manipulando os resultados da consulta 


Como a função dbx query retorna um objeto, para acessar os registros resultantes 
de uma consulta devemos usar o estilo orientado a objetos. Após a execução da 
consulta, os dados estarão disponíveis na propriedade data do objeto retornado, que 
consiste em um array de duas dimensões (linha e coluna). 


Por exemplo, vamos supor que uma consulta retorna três colunas chamadas 


D 


“nome”? “endereco” e “telefone” Utilizando índices numéricos, poderemos acessar 
os resultados da seguinte forma: 


Primeira linha: data[0][0], data[0][1], data[0)[2] 
Segunda linha: data[1] [0], data[1] [1], data{1] [2] 
«. € assim por diante. 


Se a flag de associação (DBX-RESULT ASSOC) estiver habilitada, poderemos acessar os 
dados usando os nomes das colunas como índices: 


Primeira linha: data[0]("nome'], data[0]['endereco'], data[0]['telefone"] 
Segunda linha: dataf1]['nome'], data[1]['endereco'], data[1]['telefone'] 
... e assim por diante. 


Vejamos duas formas de percorrer os resultados de uma consulta, utilizando os 
comandos de repetição for e foreach. Para utilizar o comando for, primeiramente 
precisamos obter o número de linhas resultantes, utilizando a propriedade rows do 
objeto retornado, e, posteriormente, criar um laço variando de O até esse número. 
Exemplo: 


<?php 


$res = dbx query ($con, "select * from clientes"): 
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$num Vinhas = $res->rows; 
for ($i = 0; $i < Snum linhas; $i++) 


{ 

Gnome = $res->data[$i] [0]; 

endereco = $res->data[l$i] [1]; 

$telefone = $res->data[$i] [2]; 

echo "gnome - $endereco - $telefone<br>"; 
5 
?> 


Para utilizar o comando foreach, não é necessário obter o número de linhas resul- 
tantes, pois o laço continuará sendo executado até que o último elemento do array 
data seja acessado. O código a seguir mostra como acessar os dados do resultado 
com o foreach: 


<?php 


tres = dbx. query (Scon, "select * from clientes"); 
foreach ( $res->data as Slinha ) 
i 

$nome = $linha[0]; 

endereco = $1inha[1]; 

$telefone = $linha[?]; 

echo "$nome - $endereco - Stelefone<br>"; 


?> 


Encerrando a conexão 


Após abrir a conexão e realizar as manipulações necessárias no banco de dados, a co- 
nexão deve ser encerrada com o comando dbx close, que possui a seguinte sintaxe: 


bool dbx.close (objeto id conexão) 


Portanto, após analisarmos todos os passos necessários para utilizar a extensão 
.dbx do PHP, devemos considerar a seguinte estrutura para a criação de programas 
utilizando essa extensão: 


<?php 


/! conecta ao banco de dados 

con = dbx connect C'mysgl", Sservidor, $banco, $usuario, senha); 
// executa a consulta 

$res = dbx query ($con, "select * from tabela"); 

!! trata de alguma forma os resultados 

foreach ( $res->data as $linha ) 


{ 
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} 

/f encerra a conexão 
dbx close (Scon): 

7> 


Exemplos utilizando dbx 


A extensão .dbx pode ser usada em qualquer aplicação que necessite realizar ope- 
rações sobre um dos bancos de dados suportados, Veremos agora dois exemplos: 
um programa de busca por livros e autores e outro para exibição de produtos por 
categoria. Acompanhe, então, os dois exemplos a seguir, para se familiarizar com a 
extensão .dbx e, posteriormente, utilizá-la para criar suas próprias aplicações. 


Busca por livros 


Vamos usar como exemplo uma editora, que precisa de uma página que permita 
a realização de busca por livros e autores em seu site. Antes de criar essa página, a 
primeira tarefa a se realizar é definir a tabela do banco de dados que irá armazenar 
essas informações. Vamos utilizar a mesma tabela usada no Capítulo 8, que contém 
os seguintes campos: 


"ISBN (número de registro na Biblioteca Nacional); 
= Título do livro; 

"= Nome do autor; 

= Número de páginas do livro; 

* Preço do livro. 


Para a implementação desse exemplo, utilizou-se um banco de dados MySQL. 
Porém, você pode criar sua base em qualquer outro SGBD que seja suportado 
pela extensão .dbx. A tabela será criada da seguinte forma no MySQL (por meio do 
utilitário mysql): 


create table livros 

( 
isbn varchar(13), 
titulo varchar(80) NOT NULL, 
autor varchar(80) NOT NULE, 
paginas smaflint NOT NULL, 
preco float NOT NULL 
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Esse código de criação da tabela, assim como o código para a inclusão de al- 
guns registros para fins de testes, está disponível no site da editora em um arquivo 
chamado create.sql, no endereço indicado no início deste livro. 


Para implementar esse sistema de busca, serão criadas duas páginas: 
= Jivros.htm] — página HTML contendo o formulário de busca. 


= Tivros.php — programa PHP que irá receber os dados informados pelo usuário 
e mostrar os resultados em forma de uma tabela HTML. 


A página livros.html irá conter um formulário HTML com um campo para a 
entrada do texto e um menu drop-down para o usuário escolher se deseja fazer a 
busca por “Título” ou “Autor”. O código dessa página será apresentado a seguir: 


livros.htm! 


<html> 
<head> 
«title>Livros</title> 
</head> 
<hody> 
<hl align="center">Livros da Novatec Editora</hl> 
<hr> 
<form method="POST" action="livros.php"> 
<p align="center">Busca: 
<input type="text" name="busca" size="20"> 
<setect name="chave"> 
<option selected value="titulo">Título</option> 
«option value="autor">Autor</option> 
</select> 
<input type="submit" value="Buscar” name="enviar"></p> 
</form> 
<hr> 
</body> 
</html> 


O texto digitado pelo usuário será armazenado no campo chamado “busca” e o 
critério de busca (titulo ou autor), no campo chamado “chave” Veja na figura 104 
como esse formulário é apresentado ao usuário. 


Ao clicar o botão Buscar, esses dados serão enviados para o programa livros. 
php, especificado na opção action da tag do formulário (<form), Esse programa de- 
verá montar uma consulta SQL de acordo com os dados fornecidos pelo usuário 
e, logo após, executá-la por meio dos comandos da extensão .dbx que vimos neste 
capítulo. 
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dlEnder 


Figura 10.4 — Formulário para busca de livros. 


Você verá, no código apresentado a seguir, que esse programa mistura tags HTML 
com códigos PHP. Com as tags, definimos a estrutura da tabela HTML, incluindo 
seu cabeçalho (primeira linha). As demais linhas são geradas pelo código PHP, que 
acessa o banco de dados e busca os livros que satisfaçam a consulta feita pelo usuário. 
Acompanhe, então, o programa livros.php e, logo depois, as explicações: 


livros.php 


<?php 
fchave = 5 POST['chave']: 
Sbusca = $£ POSTE busca"); 
if (strlen{$busca) < 2) 
{ 
echo "O termo a ser buscado deve ter no mínimo 2 caracteres!"; 
exit; 
} 
?> 
<html> 
<head> 
<title>Livros</title> 
</head> 
<body> 
<hl align="center">Livros da Novatec Editora</hl> 
<hr> 
<table celIspacing="3"> 
«tr bycolor="fdodeds"> 
<td><b>ISBN</b></td> 
<td><b>Título</b></td> 
<td><b>Autor</bs</td> 
<td><b>Páginas</b></td> 
</tr> 
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<?php 

$consulta sql = "select * from livros where fchave Tike '#$busca%'"; 

$servidor = "localhost"; 

Susuario = "juliano"; 

isenha = "12345": 

$banco = "test"; 

£con = dbx connect (mysql", $servidor, Sbanco, fusuario, Ísenha); 
$res = dbx query (con, fconsulta sql); 
if (is object(Sres)) 


{ 
$num_tinhas = $res->rows; 
for ($i = 0; $i < $num_linhas; $i++) 
{ 
$isbn = fres->data[$i] i0]; 
titulo = $res->data [$i] [1]; 
fautor = $res->data[$i] [2]; 
fpaginas = fres->data[fi] [3]; 
echo "<tr bgcolor=\"#eeeeee\">"; 
echo "<td>$isbn</td>"; 
echo "<td>$titulo</td>"; 
echo "<etd>$autor</td>"; 
echo "<td>$paginas</td>"; 
echo "</tr>"; 
} 
k 
dbx close (fcon); 
T> 
</table> 
<hr> 
<p align="center"><a href="Tivros .html">Voltar</a></p> 
</body> 
</html> 


As duas primeiras linhas do programa livros.php acessam o array predefinido 
$_POST para obter os dados enviados pelo usuário por meio do formulário HTML: 


chave = $ POST[' chave']; 
Sbusca = $ POSTE busca']; 


Em seguida, testa-se se o texto digitado pelo usuário possui pelo menos dois 
caracteres, encerrando o programa caso essa condição não seja satisfeita: 


if CstrlenCtbusca) < 2) 


Logo a seguir, inicia o código HTML da página, que vai até a definição da pri- 
meira linha da tabela HTML, que contém os títulos das colunas (ISBN, Título, Autor 
e Páginas). Às linhas seguintes são geradas pelo código PHP, a partir da consulta 
feita ao banco de dados. 
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Veja que o conteúdo da variável que armazena a consulta SQL foi montado de 
acordo com os valores fornecidos pelo usuário, que previamente armazenamos nas 
variáveis fchave e fbusca: 


Sconsulta sql = "select * from livros where Schave tike "ASbuscar'”; 


Essa consulta utiliza o operador SQL like para selecionar todos os registros da 
tabela livros que contenham, no campo “titulo” ou “autor” (dependendo da opção 
selecionada no formulário), o texto digitado pelo usuário. 


As variáveis que aparecem em seguida, $servidor, $usuario e $senha, devem conter as 
configurações de seu servidor de banco de dados, enquanto a variável $banco define 
o nome do banco de dados a ser acessado nesse servidor. 


Essas variáveis são passadas como parâmetro no momento da conexão, que é 
feita com o comando dbx comect, conforme vimos no decorrer deste capítulo. Nesse 
caso, estamos acessando um servidor MySQL: 


fcon = dbx connect ("mysql", Sservidor, Sbanco, Susuario, $senha); 


Após abrir a conexão, teremos o objeto resultante armazenado na variável Scon, 
que deverá ser passado como parâmetro para a função dbx query, responsável pela 
execução de comandos SQL no banco de dados: 


$res = dbx query (fcon, Sconsulta sql); 


Note que, antes de tentar acessar os resultados, se efetua um teste para verificar 
se a consulta foi executada com sucesso, ou seja, se retornou um objeto: 


if (is object(ires)) 


Se a consulta foi bem-sucedida, começamos a percorrer seus registros para a exi- 
bição das linhas da tabela HTML. O número total de registros (linhas) resultantes 
é obtido com a propriedade rows do resultado: 


$num linhas = $res->rows; 


Os registros são percorridos em um laço com o comando for, que varia de zero 
até o número de linhas do resultado: 


for ($i = 0; $1 < $num linhas; $i++) 


Dentro do laço, para cada linha acessamos a propriedade data do resultado, para 
obter os valores de seus campos e armazená-los nas variáveis $isbn, $titulo, fautor € 
$paginas do PHP: 
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$isbn = $re->data[$5] [0]; 
titulo = $res->dataj$il (1h; 
fautor = $res->data[Si](2]; 
paginas = $res->data[$Si][3]; 


Após obter os valores dos campos, utiliza-se o comando echo do PHP para produ- 
zir a saída HTML. Cria-se uma linha na tabela HTML com um tom claro de cinza 
(cor de código teeeeee), e os valores são exibidos em cada uma das quatro células 
(<td>) dessa linha: 


echo "<tr bgcolor=\"feeeeee\ ">"; 
echo "<td>$isbn</td>"; 
echo "<td>ftitulo</td>": 
echo "<td>Sautor</td>"; 
echo "<td>Spaginas</td>"; 
echo "</tr>"; 


Ao término do laço, a conexão com o banco de dados é encerrada por meio do 
comando dbx close: 


dbx close (Scon); 


A figura 10.5 mostra o resultado gerado pelo programa livros .php, obtido ao fazer 
uma busca pela palavra “sqL”, 


Livros da Novatec Editora 


8585134280 SOL - Guia de Consulta Rápida Edison Liesse 

B58518471X SQL Server 7 System Procedures - Guia de Consulta Rápida Rubens Prates, Renata Piques 
8535184701 SQL Server 7 Transaci-SOL - Gua de Consulta Rápida Rubens Prates, Renato Piques 
8535184014 Integrando PHP com MySQL - Gua de Consuba Rápida Lucio Storo 

8585124787 MySQL - Gua de Consulta Rápida Rubens Prates 

8575220128 PostgreSQL - Guia de Corisulta Rápida Juliano Niederauer 

8585184795 Oracle & SQL - Gua de Consulta Rápida Rubens Thiago de Olvera 

858518485X Oracle $i PLISQL - Guia de Consulta Rápida Celso Henrique Poderoso de Oliveira 96 
8575220209 Oracle % SQL - Guia de Consulta Rápida Rubens Thiago de Olvera 128 
8575220241 SOL - Curso Prático Celso Hennque Poderoso de Olivera 272 
8575220322 Oracle 5 PLISQL - Guia de Consulta Rápida Celso Hemque Poderoso de Obvera 112 


Figura 10.5 — Resultado da busca pela palavra “SQL. 
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Produtos por categoria 


Veremos agora o exemplo de uma loja que pretende divulgar seu catálogo de 
produtos na internet, permitindo a listagem de produtos por categoria. Para isso, 
é necessária uma página que liste todas as categorias existentes e permita que o 
usuário selecione uma delas, e outra página para exibir os produtos da categoria 
selecionada, 


Antes de criar essas páginas, primeiramente vamos definir a estrutura do banco 
de dados para armazenar as informações necessárias. Será preciso uma tabela para 
armazenar os produtos e outra para armazenar as categorias. A tabela de categorias 
terá apenas dois campos: 


* Código da categoria 

« Nome da categoria 

Na tabela de produtos serão armazenadas as seguintes informações: 
= Código do produto 

= Nome do produto 

= Descrição 

= Preço 

» Código da categoria a que o produto pertence 


Essas duas tabelas serão criadas da seguinte forma no MySQL (por meio do 
utilitário mysql): 


create table categorias 


( 
codigo smallint NOT NULL, 
nome varchar(80) NOT NULL, 
primary key(codigo) 

J: 

create table produtos 

( 


codigo mediumint NOT NULL, 
nome varchar(80) NOT NULL, 
descricao text NOT NULL, 
preco float NOT NULL, 
codigo categoria smaJlint NOT NULL, 
primary key(codigo) 

J; 
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Esse código de criação da tabela, assim como o código para a inclusão de al- 
guns registros para fins de testes, está disponível no site da editora em um arquivo 
chamado create.sql, com os códigos-fonte. 


Para implementar a listagem de produtos por categoria, serão criadas duas 
páginas: 


Página Descrição 


categorias.php Programa que irá obter todas as categorias existentes no banco 
de dados e exibi-las em uma lista de seleção (drop-down) em um 
formulário HTML. 


produtos. php Programa que irá exibir todos os produtos pertences à categoria 
selecionada pelo usuário na página categorias. php. 


A página categorias. php irá conter um formulário HTML com uma lista de seleção 
(tag <select> do HTML) para o usuário escolher a categoria que deseja visualizar. Às 
opções dessa lista (tag <option» da HTML) são definidas por meio de uma consulta 
à tabela "categorias", utilizando os comandos da extensão .dbx apresentados neste 
capítulo. O código dessa página é apresentado a seguir: 


categorias.php 


<html> 

<head> 

<title>Produtos«/title> 

</head> 

<body> 

<hl align="center">Categoria de produtos</hl> 

<form method="POST" action="produtos. php"> 

<p align="center"> 

Escolha a categoria desejada: 

«select name="categoria"> 

<?php 

Sservidor = "localhost"; 

$usuario = "juliano"; 

$senha = "12345"; 

Shanço = "test"; 

fcon = dbx connect ("mysql”, $servidor, Sbanco, Susuario, Ssenha); 
$res = dbx query (Scon, “select * from categorias"); 
fnum linhas = $res->rows; 
for ($i = 0; Si < Snum linhas; $i++) 


{ 
Sid categoria = Sres->dataf[$i] [0]; 
Scategoria = $res->data[$i] [1]; 
echo "<option value= "Sid categorial">$categoria</option>"; 
H 
dbx_close (fcon); 


To 
</select></p> 
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<p align="center"><input type="submit" valve="Listar produtos" name="enviar"></p> 
</form> 


</body> 
</html> 


Os principais trechos do programa categorias.php são Os seguintes: 


1. Definição do formulário HTML, cujos dados serão enviados ao programa 
produtos. php, responsável pela listagem dos produtos: 


«form method="POST" action="produtos.php"> 


2. Criação da lista de seleção por meio da tag HTML <select»: 


«select name="categoria”> 


3. Acesso ao banco de dados via extensão .dbx: 


$con = dbx connect (“mysgl”, $servidor, $banco, fusuario, fsenha); 


4. Execução da consulta para obtenção das categorias existentes no banco de 
dados: 


$res = dbx query ($con, “select * from categorias"); 


5. Criação do laço for para percorrer os registros resultantes. Dentro desse laço, 
para cada registro são obtidos os valores de seus campos, que são utilizados 
para formar as opções da lista: 


Sid categoria = $res->data[$i] 70]; 
fcategoria = $res->data[Si] [2]: 
echo "<option value=""$id categorial">Scategoria</option>"; 


6. A conexão com o banco de dados é encerrada: 


dbx close (fcon); 


7. Criado o botão de envio do formulário, o qual o usuário deverá clicar para 
submeter os dados ao programa que irá tratá-los: 


<input type="submit" value="Listar produtos” name="enviar"> 


A figura 10.6 mostra o resultado obtido ao executar o programa categorias.php no 
programa navegador. 


Portanto, a página PHP gerou uma lista com o nome de todas as categorias cadas- 
tradas na tabela "categorias" do banco de dados. O próximo passo é criar o programa 
que será ativado quando o usuário clicar o botão Listar Produtos. Esse programa, 
que chamaremos de produtos.php, irá receber como parâmetro o código da categoria 
selecionada e deverá listar todos os produtos que pertencem a essa categoria. 
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Categoria de produtos 


Escolha a categona desejada, [Zunin z] 


Figura 10.6 — Lista de seleção de categorias. 


Para tornar o programa consistente, antes de executar qualquer operação, de- 
vemos checar se realmente o usuário selecionou alguma categoria. Se ele não tiver 
selecionado, deverá ser exibida uma mensagem de erro e a execução deverá ser 
finalizada. Acompanhe, então, o código do programa produtos.php €, logo após, as 
explicações: 


produtos.php 


<?php 

fcategoria = $ POST['categoria']; 

if Cempty(Scategoria)) 

{ 
echo "Nenhuma categoria foi selecionada!"; 
exit; 

} 

?> 

<html> 

<head> 

<title>Produtos</title> 

</head> 

<body> 

<hl align="center">Produtos</hl> 

<hr> 


<?php 

servidor = "localhost"; 

$usuario = "juliano"; 

senha = "12345"; 

$banco = "test"; 

&con = dbx connect ("mysql", Sservidor, $banco, $usuario, Ssenha); 
$res = dbx query ($con, "select * from produtos where codigo categoria = $categoria"); 
if (is object(Sres)) 

{ 
$num_linhas = $res->rows; 
for ($i = 0; $i < num linhas; $i++} 


392 


PHP para quem conhece PHP 


{ 
$nome = $res->data[$i][1]; 
fdescricao = $res->data[$i]E?]; 
fpreco = $res->data[$i] [3]; 
$preco = number format (preco , 2, 8,8, OR 
echo "<p>"; 
echo "<b><u>fnome</u=</b> ": 
echo "<font color=red>(Ri$$preco)</font><br>"; 
echo “descricao”; 
echo "</p>"; 
H 
} 
dbx close ($con); 
?> 
</table> 
<hr> 
<p align="center"><a href="categorias.php">Voltar</a></p> 
</body> 
</html> 


Os principais trechos do programa produtos. php são os seguintes: 


1. 


Obtenção do código da categoria escolhida pelo usuário, enviada pelo for- 
mulário HTML via método POST: 


Scategoria = 4 POST[' categoria"): 
Acesso ao banco de dados via extensão .dbx: 


$con = dbx connect ("mysql", fservidor, $banco, fusuario, fsenha); 


Execução da consulta para obtenção de todos os produtos pertencentes à 
categoria selecionada pelo usuário: 


$res = dbx query (Scon, "select * from produtos where codigo categoria=fcategoria"); 


Criação do laço for para percorrer os registros resultantes. Dentro desse laço, 
para cada registro são obtidos os valores dos campos "nome", "descricao" e "preco", 
que, posteriormente, serão exibidos na tela: 

fnome = $res->data[$i] [1]; 


fdescricao = $res->data[$i] [2]; 
ípreco = $res->data[$1][3]; 


Formatação do preço com duas casas decimais, utilizando a vírgula () para 
separar as casas decimais e o ponto () como separador de milhar: 


uu m . ") : 


fpreco = number format ($preco , 2, 
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6. Ainda dentro do laço, para cada produto é criado um parágrafo (tag p>), 
onde é exibido o nome do produto em negrito e sublinhado, seu preço na 
cor vermelha (precedido pelos caracteres R$) e sua descrição: 


echo "<b><u>fnome</u></b> ": 
echo "<font color=red> (R\$$preco}</font><br>"; 
echo "$descricao"; 


A barra invertida Ô) foi usada antes do primeiro símbolo $ para indicar que 
este deve ser tratado como um caractere comum, e não como uma variável. 


7. A conexão com o banco de dados é encerrada: 
dox.close (Scon); 


8. É exibido um link para permitir o retorno à página anterior, para seleção de 
uma nova categoria: 


<a href="categorias.php">Voltar</a> 


A figura 107 mostra o resultado gerado pelo programa produtos.php, após ser 
ativado pelo usuário, ao clicar o botão Listar produtos na página. 


“É 


| pndéreço [E] hutp-ffceahestidtmjprodutos php 


Produtos 


4 DISCMAN SONY D-E35] 110-V (E8275,00) 
À Desenho compacto e leve, proteção superior anti choque, 


, RÁDIO CRAVADOR PHILEES AZ 1003 (R$245,00) 
4 Rádio gravador cora CD, ideal para você levar em suas viagens com os amigos 


| VIDEOKE RAF ELECTR VMP 9000 (R$695,00) 
À Mostre todo o seu talento com este videokê! Suas reuniões vão ficar ainda mas amadas. 


: HOME THEATER GRADIENTE SOLUTION HTS 100 R$Ẹ1. 399,00) 
4 Transforme sua casa em um verdadero cinema e sinta-se como estivesse dentro do filmel 


Figura 10.7 — Listagem dos produtos de uma categoria. 
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Utilizando a classe PEAR::DB 


A partir de agora, veremos como funciona a classe PEAR::DB, disponível para o 
PHP Será dada uma explicação passo a passo das principais operações que podemos 
realizar sobre um banco de dados usando os métodos dessa classe. 


O que é PEAR? 


PEAR, em inglês, significa pêra, tanto que o logotipo oficial do projeto é a imagem 
dessa fruta. Porém, na realidade PEAR é uma sigla, e seu verdadeiro significado é 
“PHP Extension and Application Repository” ou seja, Repositório de Extensões e 
Aplicações PHP 


O objetivo do PEAR é fornecer aos desenvolvedores uma biblioteca estruturada 
de códigos-fonte abertos, assim como um sistema para distribuição de código e 
manutenção de pacotes. O endereço oficial é: 


http://pear.php.net 


Acessando esse site, você encontrará toda documentação sobre o PEAR, além de 
todos os pacotes disponíveis para download. Os pacotes estão divididos em catego- 
rias, como Banco de Dados (Database), Cache (Caching), Criptografia (Encryption), 
E-mail (Mail), Imagens (Images), Matemática (Math), XML etc. 


Esses pacotes são desenvolvidos e mantidos por diferentes grupos de pessoas, € 
cada pacote tem sua documentação separadamente. 


No site, você encontrará ainda links para as listas de discussão do PEAR, nas 
quais você poderá se comunicar com outros desenvolvedores da comunidade 
PHP/PEAR. 


Neste livro, será apresentado um dos pacotes do PEAR, que é a classe DB, uma 
camada de abstração de banco de dados. 


Instalação do pacote DB ou MDB2 


O PEAR possui um gerenciador de pacotes chamado PEAR package manager, que 
permite a instalação de novos pacotes, gerenciamento dos pacotes já instalados e 
verificação de dependência entre eles. Esse gerenciador tem sua funcionalidade 
semelhante ao “apt-get”, do Debian Linux, para atualização do sistema. 


Se sua versão do PHP é maior que ou igual a 430), a instalação básica do PEAR 
já estará incluída em seu sistema, a não ser que o PHP tenha sido compilado com 
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a opção -without-pear. Essa instalação básica já inclui as ferramentas de instalação 
do PEAR, assim como as principais classes, chamadas de PHP Foundation Classes 
(PFC). A classe DB, que será apresentada neste capítulo, está entre elas. 


Nas versões do PHP a partir da 43.2, você encontrará um script chamado go-pear. 
bat, que poderá ser executado para instalar o PEAR package manager no diretório 
desejado. Basta executar esse arquivo e seguir as instruções. Na realidade, esse arquivo 
go-pear .bat solicita a execução do script de instalação chamado go-pear .php. Portanto, 
se você não encontrá-lo, poderá executar diretamente o script de instalação: 


php go-pear.php 


Se sua versão do PHP for anterior a 4.30, será necessário obter o script de insta- 
lação do gerenciador, Esse script está disponível em http: //go-pear.org. 


Para executá-lo no Linux, pode-se utilizar o browser da linha de comando Tynx 
(ou links, dependendo da distribuição), da seguinte forma: 


Tynx -source http://go-pear.org | php 


No caso do Windows, basta salvar o script obtido em http://go-pear.org e executá- 
lo com o interpretador do PHP: 


php go-pear.php 


O instalador deve acrescentar automaticamente o caminho para as classes do 
PEAR na diretiva include path de seu arquivo de configuração php. ini. 


Após finalizada a instalação do gerenciador PEAR package manager, você po- 
derá usar o instalador da linha de comando (CLI — Command Line Installer) para 
instalar os pacotes desejados. Esse instalador denominado pear abre uma conexão 
HTTP com o servidor de pacotes do PEAR, obtém o pacote indicado e o instala no 
diretório especificado. A sintaxe para instalação é a seguinte: 


pear install] <pacote> 


Por exemplo, para o pacote DB, teremos: 


pear install DB 


Para instalar o pacote MDB2, teremos: 
pear install MDB2 


Lembre-se de que dependendo de sua versão do PHP, é possível que a classe DB 
já tenha sido instalada com o gerenciador. O arquivo principal dessa classe é o DB. php, 
que deve estar no diretório onde as classes do PEAR foram instaladas. Nesse caso, 
você não precisará instalá-la por meio do instalador da linha de comando. 
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Incluindo a chamada para a classe 


A partir de agora, veremos passo a passo como criar um programa PHP que acesse 
um banco de dados utilizando os comandos da PEAR: :DB, A primeira tarefa a ser feita, 
antes de usar qualquer comando, é incluir uma chamada para a classe DB no início 
de seu programa. Exemplo: 

<?php 

require once 'DB.php'; 

?> 

Não será necessário especificar o caminho para o arquivo DB.php, visto que o 


instalador já adicionou o caminho do PEAR aos existentes na diretiva include path 
do arquivo php. ini. 


Veja que para chamar a classe, utilizou-se o comando require_once em vez do co- 
nhecido comando include. Isso foi feito para evitar a geração de um erro caso algum 
trecho do script tente incluir a classe novamente, 


DSN — Data Source Name 


Para acessar um banco de dados por meio da classe PEAR: :D8, deve-se criar um DSN 
válido. A sigla DSN significa Data Source Name, ou seja, Nome da Fonte de Dados. 
Trata-se de uma string com um determinado formato, contendo as informações ne- 
cessárias para acessar o banco de dados. Um DSN é formado pelas seguintes partes: 


Parte Descrição 


tipophp SGBD a ser acessado pelo PHP. Entre os valores possíveis, temos mysql 
(MySQL), pasgl (PostgreSQL), ibase (InterBase), msql (Mini SQL), 
mssql (Microsoft SQL Server), oci8 (Oracle 7/8/8i), odbe (ODBC), sybase 
(SyBase), ifx (Informix) e fbsql (FrontBase). 

sintaxebd Permite especificar uma sintaxe SQL a ser usada no banco de dados. 

protocolo Protocolo de comunicação a ser usado (exs.: tcp, unix etc.) 


servidor Endereço do servidor (nomeservidor[:porta])). 
banco Nome do banco de dados a ser acessado no SGBD. 
usuaria Nome de usuário a ser usado na conexão. 

senha Senha a ser usada na conexão. 

op proto Pode ser usada com o protocolo. 


Em sua forma completa, um DSN possui a seguinte estrutura: 


tipophpíósintaxebd): //usuario: senhafprotocolorservidor/banco 
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Veja a seguir algumas variações que são permitidas: 


tipophp: //usuario: senhaGprotocolo+servidor :110//usr/arquivo.db 
tipophp://usuario: senhafiservidor /banco 

tipophp://usuario: senhafservidor 

tipophp: //usuariofiservidor 

tipophp://servidor/banco 

tipophp://servidor 

tipophp 


A seguir, será apresentado um exemplo de definição de um DSN para acesso 
a um banco de dados MySQL. São declaradas quatro variáveis contendo o nome 
do usuário, senha, setvidor e nome do banco de dados, que posteriormente serão 
utilizadas para a criação da string do DSN: 

<?php 

require once 'DB.php'; 

fusuario = "juliano"; 

isenha = '12345'; 

$servidor = "ocalhost'; 


&banco = test"; 
$dsn = "mysql ://$usuario: fsenhaf$servidor/Sbanco”; 


?> 


Como veremos no próximo tópico, o DSN deverá ser passado como parâmetro 
para a função de conexão com o banco de dados. 


Conectando ao banco de dados 


Para abrir uma conexão com um banco de dados, deve-se utilizar a função DB:: 
comect O), que possui a seguinte sintaxe: 


objeto DB::connect (string $dsn [, boolean Sopções = FALSE]) 


Parâmetro Descrição 
$dsn Deve conter um DSN válido (veja tópico anterior). 
fopções Opções da conexão, como, por exemplo, a indicação se deve ser esta- 


belecida uma conexão persistente ou não, 


Se a conexão for aberta com sucesso, essa função retornará um objeto de conexão, 
que deveremos usar posteriormente para executar operações no banco de dados. 
Após a execução da função DB: :comect(), é recomendável verificar se ocorreu algum 
erro, por meio da função DB: :isError(). Veja a seguir um exemplo de conexão com 
um banco de dados MySQL: 
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<?php 
require once 'DB.php': 
Susuario = "juliano"; 
senha = "12345"; 
servidor = 'Tocalhost'; 
fbanco = 'test'; 
$dsn = "mysql: //Susuario: $senhaffservidor/Sbanco"; 
$db = DB::connect($dsn); 
if (DB: :isError($db)) { 

die (Sdb->getMessage()); 
k 


?> 


Executando consultas SQL 


Após abrir uma conexão com um banco de dados, podemos utilizar a função queryQ) 
para executar comandos SQL sobre ele. A sintaxe dessa função é a seguinte: 


misto &query (string $comando [, array Sparámetros]) 


Parâmetro Descrição 


$comando Comando SQL a ser executado no banco de dados. 
fparâmetros Dados a ser adicionados à consulta. 


Em caso de êxito na execução de um comando SQL SELECT, essa função retorna 
um objeto de resultado (DB Result). Para outras operações, é retornado o valor DB Ok. 
Em caso de falha, é retornado um objeto de erro (DB Error). Por isso, também é 
recomendável testar a ocorrência de algum erro com a função DB: :isError(). Veja a 
seguir um exemplo de execução de uma consulta: 


<?php 


$sql = "select * from tabela"; 
$resultado = $db->query(ásgl); 
if (DB: :istrror($resultado)) E 

die (Sresult->getMessage()); 
) 


7> 
Após a execução dessa consulta, os registros resultantes poderão ser acessados 


por meio do objeto retornado na variável $resultado. A classe PEAR::DB nos oferece 
diferentes formas de manipular esse resultado, 


O objeto do resultado nos disponibiliza duas funções para obter as linhas re- 
sultantes: fetchRow() e fetchInto(). 


Capítulo 10 « Acesse um banco de dados! Não importa qual... 399 


A função fetchRowQ) retorna uma linha do resultado e não tem parâmetros obriga- 
tórios, enquanto a fetchIntoQ recebe um array como parâmetro, ao qual será atribuída 
alinha do resultado. Ambas podem ser usadas por meio de um laço com o comando 
while, que se encerrará automaticamente quando a última linha for acessada. 


Por exemplo, para exibir o primeiro campo de cada linha do resultado utilizando 
a função fetchRow(), teremos: 


while CSlinha = $resultado->fetchRowQ)) { 
&campo = $1inha[0]; 
echo $campo; 

} 


Para exibir esse mesmo campo, mas utilizando a função fetchInto(), teremos: 
while (Sresuttado->fetchInto(Slinha)) { 
Scampo = $linha[0]; 


echo fcampo; 


} 


Além dos dados, existem funções que nos permitem obter outras informações 
sobre a consulta, como, por exemplo: 


: número de linhas resultantes: $resultado->numRows() ; 
= número de colunas resultantes: $resultado->numlols(); 


= número de linhas afetadas, no caso dos comandos INSERT, UPDATE e DELETE: 
£db->affectedRows O. 


Ao terminar o processamento do resultado, é recomendável liberar o espaço de 
memória alocado para esses registros, utilizando a função freeQ). Portanto, teremos 
a seguinte estrutura para executar uma consulta: 


<?php 


$resultado = $db->query{'SELECT * FROM tabela'); 
while ($linha = $resultado->fetchRowO) i 


} 
&resultado->free(); 
?> 


Modos de busca do resultado 


Entre os modos disponíveis para acessar os registros do resultado de uma consulta 
SQL, temos os seguintes: 
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Modo Descrição 


DB FETCHMODE. ORDERED É o valor-padrão. Retorna um array ordenado, utilizando a 
ordem das colunas especificadas no comando SELECT. 


DB FETCHMOÓDE ASSOC Retorna umatray associativo utilizando os nomes dos campos 
como chaves, 


DB FETCHMODE OBJECT Retorna um objeto de linha (DB Row), utilizando os nomes 
das colunas como propriedades. 


Essas constantes podem ser passadas como parâmetros para a função fetchRow(), 
no momento da busca pelas linhas do resultado. Veja a seguir um exemplo de uso 
para cada um desses três modos. 


Com um array ordenado, são usados índices numéricos para acessar Os campos 
do registro: 

<?php 

$res = Sdb->query(' SELECT codigo, nome FROM clientes'); 

$linha = $res->fetchRow(DB FETCHMODE ORDERED); 

codigo = $linha[0]; 

fnome = $tinha[1]; 

» 

Com um array associativo, para acessar os valores dos campos, devemos usar 
seus nomes como chaves do array resultante: 

<?php 

$res = $db->query(' SELECT codigo, nome FROM clientes '); 

$linha = $res->fetchRow(DR FETCHMODE ASSOC); 

Scodigo = $linhal' codigo']; 

gnome = $linha['nome'); 

> 

Com um objeto de linha, os valores dos campos são acessados com uma sintaxe 
orientada a objetos, com os caracteres “->”: 

<?php 

$res = $db->query(' SELECT codigo, nome FROM clientes"); 

$linha = $res->fetchRow(DB FETCHMODE OBJECT): 

$codigo = $linha->codigo; 


gnome = $Elinha->nome; 


?> 
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Outras funções úteis para retorno de dados 


A classe PEAR: :DB ainda nos disponibiliza uma série de funções para o retorno rápi- 
do de um determinado dado ou conjunto de dados resultantes de uma consulta. 
Se as utilizarmos, não haverá necessidade de executar as outras funções de busca 
(fetchRow € fetchInto). 


A seguir, serão apresentadas essas funções, que seguem o formato get*() e rea- 
lizam automaticamente todo o processo, incluindo a consulta, busca do resultado 
e liberação da memória. 


getOne() 


Retorna a primeira coluna da primeira linha do resultado da consulta. Será muito 
útil quando realizarmos consultas que retornam um único valor. Exemplo: 
<?php 


$num clientes = $db->getOne(' SELECT count(*) FROM clientes"); 
7> 


getRowi) 


Obtém a primeira linha do resultado e retorna um array. Exemplo: 


<?php 
$sql = 'SELECT nome, endereco FROM clientes WHERE codigo=100"; 
if Gis array($linha = $db->getRow(£sql))) É 
$nome = $Hinha[0]; 
fendereco = Slinha[1]; 
} 


7> 
getCol() 


Retorna um array contendo os dados da coluna selecionada. Exemplo: 


<?php 
array nomes = Sdb->getCol('SELECT nome FROM clientes"); 
?> 


getAssocl) 


Retorna um array associativo contendo todos os registros resultantes de uma con- 
sulta SQL, utilizando a primeira coluna como chave. Exemplo: 
<?php 


Sdados = getAssoc(' SELECT nome, cidade, estado FROM clientes"); 
?> 
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Essa consulta irá retornar um array associativo usando os valores do campo 
nome como chave, A seguir, um exemplo de estrutura do array que poderia ser re- 
tornado: 


array( 
“Juliano” => array('Porto Alegre", 'RS'), 
'Sidvio! => array('São Paulo", "SPO, 
"Garotinho" => arrayC'Rio de Janeiro", "RJ') 


getAII() 


Retorna um array contendo todos os registros resultantes de uma consulta SQL. 
Por exemplo: 
<?php 


$dados = getATT(' SELECT nome, cidade, estado FROM clientes"); 
?> 


Essa consulta irá retornar um array usando chaves numéricas. A seguir, um 
exemplo de estrutura do array que poderia ser retornado: 


array( 
1 => array('Juliano", 'Porto Alegre", 'RS'), 
2 => arrayC'Silvio", São Paulo', "SP", 
3 => array( Garotinho", "Rig de Janeiro", 'RJ') 


Encerrando a conexão 


Após abrir a conexão e realizar todas as manipulações necessárias no banco de 
dados, a conexão deve ser encerrada com o comando disconnect(Q), que possui a 
seguinte sintaxe: 


bool DB: :disconnect () 


Portanto, após analisarmos todos os passos necessários para utilizar a classe 
PEAR: :DB no acesso a bancos de dados, devemos considerar a seguinte estrutura para 
a criação de programas utilizando essa classe: 


<?php 

require once 'DB.php': 

Susuario = "juliano"; 

$senha = "12345; 

fservidor = "localhost"; 

fbanco = 'test'; 

$dsn = “mysql: //Susuario: Ssenhab$servidor/Sbanco"; 
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$db = DB::connect(Sdsn); 
$sql = "select * from livros limit 3º; 
$res = $db->query ($sql); 
while C$linha = Sres->fetchRow0) { 


; . 


$res->free{); 


fdb->disconnect(); 
?> 


Exemplos utilizando PEAR::DB 


Você pode usar a classe PEAR: :D8 em qualquer aplicação que necessite realizar opera- 
ções sobre um dos bancos de dados suportados por ela. Veremos agora dois exemplos 
envolvendo um campeonato de futebol: um programa que lista os jogos da rodada 
e outro que exibe os cinco principais goleadores do campeonato. Acompanhe, então, 
os dois exemplos a seguir, para se familiarizar com a classe DB e, posteriormente, 
utilizá-la para criar suas próprias aplicações. 


Jogos da rodada 


Nosso primeiro exemplo consiste em uma página que exibe os jogos de futebol 
que serão realizados no dia atual, Antes de criar essa página, a primeira tarefa a 
ser feita é definir a tabela do banco de dados que irá armazenar essas informações. 
Essa tabela irá conter os seguintes campos: 


= jogo a ser realizado (ex.: Timel x Time2); 
* local do jogo (estádio); 

« horário de início; 

= data do jogo. 


Para a implementação desse exemplo, utilizou-se um banco de dados MySQL. 
Porém, você pode criar sua base em qualquer outro SGBD que seja suportado pela 
classe PEAR: :DB. A tabela será criada da seguinte forma no MySQL (por meio do 
utilitário mysql): 


create table jogos 

( 
jogo varchar(100) NOT NULL, 
local varchar(50) NOT NULL, 
horario char(5) NOT NULL, 
data date NOT NULL, 

J; 
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Esse código de criação da tabela, assim como o código para a inclusão de al- 
guns registros para fins de testes, encontra-se disponível no site da editora em um 
arquivo chamado create. sql, com os códigos-fonte. Veja a seguir alguns exemplos de 
comandos SQL para inserção de jogos nessa tabela. Nesses comandos, estão sendo 
incluídos os jogos realizados no dia 19 de outubro de 2003: 

insert into jogos values ("Grêmio x Atlético-MG", 'Olímpico",'20:30",'2003-10-19"): 

insert into jogos values ("Guarani x Fluminense", 'Brinco de Quro!,'20:30",'2003-10-19'); 

insert into jogos values C'Criciúma x Vasco", 'Heriberto Hulse",'20:30','2003-10-19'); 


insert into jogos values ('Vitória x São Caetano", 'Barradão”",'20:30','2003-10-19'): 
insert into jogos values ("Cruzeiro x Juventude", 'Mineirão",'20:30','2003-10-19'); 


Para facilitar o entendimento desse sistema, vamos separá-lo em dois arquivos: 


Arquivo Descrição 


jogos.php Nessa página será definida uma tabela HTML, que será usada para 
exibir as informações sobre os jogos do dia atual. Haverá também 
uma chamada para o script que irá gerar as linhas dessa tabela, 


lista jogos.inc Será chamado pela página jogos.php. É o script responsável por 
acessar o banco de dados, obter as informações sobre os jogos do 
dia atual e exibi-las na tabela HTML. 


A seguir, será apresentado o código da página jogos.php, que, em sua maioria, se 
trata apenas de HTML. Existem apenas dois trechos de códigos PHP sendo um 
deles para exibir a data atual e outro para chamar o script lista jogos. inc: 


jogos.php 


<html> 
<head> 
<title>Campeonato Brastleiro</title> 
</head> 
<body> 
<hi align="center">Campeonato Brasileiro</hl> 
<p align="center">Confira os jogos de hoje (<?php echo date("d/m/Y"); 7>):</p> 
<div align="center"> 
<center> 
<table border="1"> 
<tr> 
<td bgcolor=" #D6D6D6" ><b>Horário</b></td> 
<td bgcolor="#0606D06"><b>Jogo</b></td> 
<td bgcolor="4D6D6D6"><b>Local</b></td> 
</tr> 
<?php include "lista_jogos.inc"; ?> 
</table> 
</center> 
</div> 
</body> 
</html> 
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Veja que foi definida apenas a primeira linha da tabela HTML, na qual foram 
escritos, em negrito, os títulos de cada coluna. As demais linhas serão geradas 
pelo script Vista jogos inc apresentado a seguir. Esse script abre uma conexão com 
o banco de dados usando a classe PEAR: :DB, executa uma consulta SQL para obter 
as informações necessárias (jogo, data e hora) e as exibe na tabela HTML com o 
comando echo do PHP: 


lista jogos.inc 


<?php 

require once 'DB.php'; 

$usuario = "juliano"; 

$senha = "12345"; 

Sservidor = 'localhost'; 

$banco = 'test'; 

$dsn = "mysql://Susuario: $senhað$servidor/$banco"; 


$db = DB::connect(fdsn); 
Shoje = date("Y-m-d"); 
$sql = "SELECT jogo, local,horario FROM jogos WHERE data='Shoje'” 
$res = $db->query ($sql); 
while ($linha = $res->fetchRow0)) É 
Sjogo = $hinhal0]; 
$local = $linha[1]; 
horario = Slinha[2]; 
echo "<tr>"; 
echo "<td>Shorario</td>": 
echo "<td>$jogo</td>"; 
echo "<td>Slocal</td>"; 
echo "</tr>"; 
k 
Sres->free(); 
tdb->disconnect(); 
7> 


Veja que para compor a consulta SQL, utilizou-se a função date do PHP para 
obter a data atual no formato AAAA-MM-DD: 


Shoje = date("Y-m-d'); 
$sql = "select jogo, local,horario from jogos where data='fhoje'”; 


Se seu sistema gerenciador de banco de dados usa um formato diferente, basta 
alterar o valor do parâmetro da função date, especificando o formato desejado. Se o 
script jogos.php fosse acessado no dia 19 de outubro de 2003, teríamos o resultado 
mostrado na figura 10.8. 
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bCampeo 


Campeonato Brasileiro 


Confira os jogos de hoje (1908/2003): 


30 [Grêmio x Atlético-MG Olimpico 
[Guarani x Fluminense fBrinco de Ouro, 
| | |Henberto Hulse; 


(Mineirão 


Figura 10.8 — Jogos do dia 19/08/2008. 


Goleadores do campeonato 


Nosso segundo exemplo consiste em uma página que exibe os cinco jogadores que 
mais marcaram gols em um campeonato de futebol. Antes de criar essa página, 
primeiramente vamos definir a tabela do banco de dados que irá armazenar as 
informações. Essa tabela irá conter os seguintes campos: 


= nome do jogador; 
"= time no qual ele joga; 
=- quantidade de gols marcados. 


Para a implementação desse exemplo, utilizou-se um banco de dados MySQL. 
Porém, você pode criar sua base em qualquer outro SGBD que seja suportado pela 
classe PEAR: :DB. A tabela será criada da seguinte forma no MySQL (por meio do 
utilitário mysql): 


create table goleadores 

( 
nome varchar(100) NOT NULL, 
time varchar(50) NOT NULL, 
gols smallint NOT NULL, 

Ji 
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Veja a seguir alguns exemplos de comandos SQL para inserção de jogadores 
nessa tabela: 


insert into goleadores values C'Dimba', 'Goiás!, 20); 

insert into goleadores values (' Luís Fabiano”, 'são Paulo!, '18'); 
insert into goleadores values ('Aristizábal", "Cruzeiro", "155; 
insert into goleadores values (Róbson", ‘Paysandu’, '15'); 
insert into goleadores values ('Marcel', 'Coritiba', '12'); 


Assim como foi feito no exemplo anterior, para facilitar o entendimento desse 
sistema vamos separá-lo em dois arquivos: 


Arquivo Descrição 


goleadores. php Nessa página será definida uma tabela HTML, que será 
usada para exibir as informações sobre os goleadores do 
campeonato. Haverá também uma chamada para o script 
que irá gerar as linhas dessa tabela. 


lista goleadores.inc Será chamado pela página goleadores «php. É o script respon- 
sável por acessar o banco de dados, obter as informações € 
exibi-las na tabela HTML. 


A seguir, será apresentado o código da página goleadores .php, que, em sua maioria, 
trata-se apenas de HTML. Existe apenas um trecho de código PHP, que é a chamada 
para o script lista goleadores. inc. 


goleadores.php 


<html> 

<head> 

«title>Goleadores do Campeonato</title> 

</head> 

<body> 

<hl align="center">Goteadores do Campeonato</hl> 

<p align="center">0s cinco jogadores que mais marcaram gols são:</p> 
«div align="center"> 


<center> 
<table border="1"> 
<tr> 
<td bgcolor="4D6D6D6"><b>Jogador</b></td> 
<td bgcolor="4D6D6DE"><b>Time</b></td> 
<td bgcolor="#06D606"><b>Gols</b></td> 
</tr> 
<?php include "Vista goleadores.inc”; ?> 
</table> 
</center> 
</div> 
</body> 


</html> 
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Na primeira linha da tabela HTML, foram escritos, em negrito, os títulos de cada 
coluna. As demais linhas serão geradas pelo script lista goleadores. inc, apresentado 
a seguir, Esse script abre uma conexão com o banco de dados usando a classe PEAR:: 
DB, obtém as informações necessárias (nome, time e gols) sobre os cinco maiores 
goleadores e as exibe na tabela HTML com o comando echo do PHP: 


lista goleadores.inc 


<?php 

require once "DB.php'; 

$usuario = "juliano"; 

$senha = "12345"; 

servidor = Mocalhost'; 

Sbanco = 'test'; 

Sdsn = "mysql: //fusuario: Ssenhaf$servidor/Sbanco"; 

$db = DE: :connect($dsn); 

$sql = "SELECT * FROM goleadores ORDER BY gols DESC LIMIT 5"; 

$res = $db->query ($sq]); 

white ($tinha = Sres->fetchRowO) 1 
$nome = $Tinha[0); 
$time = $linha[1]: 
$gols = $1inha{2]; 
echo "<t>"; 
echo "<td>$nome</td>": 
echo "<td>$time</td>"; 
echo "<td>$gols</td>"; 
echo "</tr>": 

} 

$res->freeQ); 

&db->disconnect(); 

?> 


Observe a consulta SQL que foi executada: 


$sql = "SELECT * FROM goleadores ORDER BY gols DESC LIMIT 5"; 


Essa consulta utiliza a cláusula ORDER BY da linguagem SQL para ordenar o resulta- 
do pela coluna gols e a opção DESC para indicar que a ordenação deve ser decrescente. 
Dessa forma, serão retornados primeiro os jogadores que têm o maior número de 
gols. Utilizou-se também a cláusula LIMIT com o valor 5, para que sejam retornados 
apenas os cinco primeiros jogadores de acordo com a ordem especificada. 


A figura 10,9 mostra o resultado que obtemos ao acessarmos a página goleadores. 
php no programa navegador. 
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Goleadores do Campeonato 


Os cinco jogadores que mais marcaram gols são: 


Figura 10.9 — Goleadores do campeonato. 


Exemplo com a classe PEAR::MDB2 


Veremos agora rapidamente um exemplo de uso da classe MDB2 do PEAR, que assim 
como a classe DB, também implementa abstração de banço de dados. Conforme 
explicado no tópico sobre a instalação do pacote DB, você pode agir da mesma forma 
para instalar também o pacote MDBZ2, por meio do PEAR package manager. 


Aproveitando o exemplo apresentado no tópico anterior, que consulta o banco de 
dados para exibir os goleadores do campeonato, vamos ver como alterá-lo para que 
passe a utilizar a classe PEAR: :MDB2, em vez da PEAR: :DB, já apresentada neste capítulo. Será 
alterado apenas o script lista goleadores. inc, que é responsável pelo acesso ao banco 
de dados. O script utilizando a MDB2 será chamado de lista goleadores2 inc. 


Observando o código a seguir, você irá perceber que, em termos de programação, 
há muito pouca diferença entre as duas classes: 


lista goleadores2.inc 


<?php 

require once 'MDB2.php'; 

tusuario = "juliano"; 

Ssenha = "12345"; 

$servidor = "localhost"; 

fbanco = 'test'; 

$dsn = "mysql ://Susuario: $senhaQ$servidor/Sbanco”; 
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$db = MDB2::connect(Sdsn); 
if (PEAR::IsError(Sdb)) { 
die(idb->getMessage()):; 
} 
$sql = “select nome, time,gols from goleadores order by gols desc limit 5"; 
$res = $db->query ($sql); 
while ($linha = $res->fetchRowQ)) 
1 
fnome = $linha(0]; 
$time = Slinhafl); 
$gols = $linha[?]; 
echo "<tr>"; 
echo "<td>$nome</td>"; 
echo "<td>$time</td>"; 
echo "<td>fgols</td>"; 
echo "</tr>"; 


} 


?> 


Com poucas modificações no script lista goleadores. inc, fazemos com passe a 
usar a classe MDB2. 


Se você quiser testar esse script, altere a linha do código do programa goleadores. 
php onde é feita a chamada para o script lista goleadores. inc, para lista goleadores?, 
inc. À documentação completa do pacote MDB? pode ser encontrada no manual 
do PEAR, no endereço http: //pear.php.net. 


Funções do PHP para a extensão DBX 


Além das principais funções que vimos neste capítulo, existem outras funções adi- 
cionais disponíveis na extensão .dbx. A seguir, serão apresentadas as funções que 
podemos utilizar e uma pequena descrição de cada uma delas. 


dbx dose 
Fecha uma conexão (aberta com o comando dbx connect) com um banco de 


dados. Retorna TRUE, em caso de sucesso, € FALSE, se falhar. 


bcol dbx close (objeto id. conexão) 


dbx compare 
Compara duas linhas para fins de ordenação. Recebe como parâmetro dois 
arrays e retorna O se o elemento correspondente à chave indicada for igual 
nos dois arrays, 1 se o primeiro for maior que o segundo e -1 se o segundo 
for maior que o primeiro. 


int dbx compare (array linha a, array linha b, string chave.coluna [, int flags]) 
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dbx_connect 


Abre uma conexão com um banco de dados. Retorna um objeto em caso de 
sucesso € FALSE se ocorrer algum erro. 


objeto dbx connect (misto módulo, string servidor, string banco, string usuário, 
string senha [, int persistente)) 
dbx error 


Retorna a mensagem de erro referente à última função executada pelo módulo 
do banco de dados. 


string dbx error (objeto id conexão) 


dbx escape string 


Adiciona caracteres de escape a um texto, para que este possa ser usado em 
um comando SQL sem gerar erros na sintaxe. 


string dbx escape string (objeto id conexão, string texto) 


dbx fetch row 


Busca linhas de um resultado que possui a flag DEX RESULT UNBUFFERED 
habilitada. 


misto dbx fetch row (objeto id resultado) 


dbx query 


Envia um comando SQL ao banco de dados e obtém os resultados. Retorna 
um objeto de resultado (se a consulta retornar registros) ou o valor 1 em caso 
de sucesso, e O em caso de falha. 


objeto dbx query (objeto id conexão, string comando sq? [, Tong Flags]) 


dbx sort 
Ordena os registros resultantes de uma consulta utilizando uma função de 
ordenação personalizada. Sempre que possível, é recomendável utilizar a 
cláusula ORDER BY do SQL em vez dessa função. 


bool dbx sort (objeto resultado, string Função comparação usuário) 


Funções da extensão PEAR::DB 


A seguir, serão apresentadas as funções disponibilizadas pela PEAR::DB, assim 
como uma rápida descrição de cada uma delas. Essas funções estão divididas em 
três classes: DB, DB. Common € DB Result. Acompanhe a seguir a explicação sobre cada 
uma delas. 
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Classe DB 


É a classe principal do pacote DB. Contém alguns métodos estáticos para a criação 
de objetos de banco de dados. 
DE: connecti 

Conecta a um determinado banco de dados e retorna o objeto de conexão. 


objeto DB: :connect (string $dsn [, boolean $opções = FALSE) 


DB::isWarning() 


Verifica se um determinado código de resultado gerado por um método DB 
é um aviso (warning). 


boolean DB: :isWarning (PEAR Error $valor) 


DB::isError() 


Verifica se um determinado código de resultado gerado por um método DB 
é um erro (objeto DB Error). 


boolean DB: :isError (misto valor) 


Classe DB Common 


É a classe que fornece todos os métodos para a execução de consultas sobre um 
determinado banco de dados. 


DB Common::affectedRows() 


Retorna o número de linhas afetadas em operações de inclusão (INSERT), 
atualização (UPDATE) ou exclusão (DELETE). 


inteiro affectedRows (O) 


DB Common::autoExecute() 


Executa automaticamente uma consulta de inserção (INSERT) ou atualização 
(UPDATE), chamando os métodos prepare() e execute O. 


DB Result autofxecute (string $tabela, array $valores campos 
É, inteiro modo = DB AUTOQUERY INSERT [, string fapós where = FALSE] ]) 
DB Common::autoPrepare() 


Prepara automaticamente uma consulta de inserção (INSERT) ou atualização 
(UPDATE), chamando o método prepared). 


recurso autoPrepare (string $tabela, array Scampos tabela, inteiro 
$modo = DB AUTOQUERY. INSERT [, string Sapós where = FALSE]) 
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DB Common::createSequence() 


Cria uma nova seqüência. As sequências são uma forma de utilizar o auto- 
incremento para o valor de determinados campos. 


inteiro createsequence (string $nome segiência) 


DB Common::disconnect() 


Fecha a conexão com um banco de dados, aberta com 08::comectO. Retorna 
TRUE, em caso de sucesso, e FALSE, em caso de falha. 


boolean DB: :disconnect O 


DB Common::dropSequencel) 
Exclui uma sequência que foi criada com o método createSequence(). 


inteiro dropSequence (string $nome segiiência) 


DB Common::execute() 


Executa um comando SQL previamente preparado com o método prepare(), 
acrescentando-lhe os dados fornecidos. 


misto execute (recurso comando, array $dados) 


DB Common::executeMultiple() 


Executa repetidamente um comando SQL previamente preparado com o 
método prepare(), acrescentando-lhe os dados fornecidos. O comando é 
executado para cada linha do array de dados passado como parâmetro. 


misto executeMultiple (recurso $comando, array $dados) 


DB Commoan::getAl) 


Obtém todas as linhas resultantes de uma consulta SQL, retornando-as em 
um array Libera automaticamente a memória ao término da execução. 


array &getAl) (string $consulta [, array fparâmetros = array) 
[, inteiro $modobusca = DB. FETCHMODE, DEFAULT] ]) 


DB Common::getAssoc() 


Obtém todas as linhas resultantes de uma consulta SQL, retornando-as em 
um array associativo, onde a primeira coluna é utilizada como chave. Libera 
automaticamente a memória ao término da execução. 


array &getAssoc (string $consulta, boolean [Sforcar array = FALSE], array [$parâmetros 
= array) [, inteiro $modobusca = DB FETCHMODE. DEFAULT [, boolean Sgrupo = FALSE] P 
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DB Common::getCol() 


Retorna um array contendo os dados da coluna selecionada pela consulta. 
Libera automaticamente a memória ao término da execução. 


array &getCol (string $consuita [, misto $co] = 0 [, array $parâmetros = array()H) 


DB Common::getListOf() 


Retorna informações sobre os bancos de dados disponíveis, usuários, visões 
e funções. 


misto getListOf (string $tipo) 


DB Common::getOne() 


Retorna a primeira coluna da primeira linha do resultado da consulta. Libera 
automaticamente a memória ao término da execução. 


misto &getOna (string $consulta [, array $parâmetros = array]) 


DB Common::getRow() 


Obtém a primeira linha do resultado da consulta e retorna um array. Libera 
automaticamente a memória ao término da execução. 


array &getRow (string Sconsulta [, array Sparâmetros = arrayQ) 
[, inteiro Smodobusca = DB FETCHMODE DEFAULT] ]) 


DB Common::limitQuery() 


Envia ao banco de dados uma consulta limitada. É uma emulação para a 
opção LIMIT do MySQL, ou seja, permite que seja retornado somente um 
determinado número de linhas. 


misto &limitQuery (string Sconsulta, inteiro finício, inteiro $num Jinhas) 


DB Common::nextid() 


Retorna o identificador seguinte de uma sequência. Em caso de falha, retorna 
um objeto de erro (DB Error). 


recurso nextId (string $nome segiência, boolean $criar seq = TRUE) 


DB Common::prepare() 


Prepara um comando SQL para execução. À execução é feita posteriormente 
com o método execute(). 


recurso prepare (string fconsulta) 


Capítulo 10 = Acesse um banco de dados! Não importa qual... 415 


DB. Common::pravides() 


Verifica se uma determinada característica está disponível para o tipo de 
banco de dados escolhido. 


boolean provides (string $característica) 


DB. Common::query() 


Envia uma consulta ao banco de dados. Para comandos SELECT, retorna um 
objeto de resultado (se houver linhas resultantes). Para as demais operações, 
retorna o valor D8.0K. Em caso de falha, retorna um objeto de erro (DB. Error). 


misto &query (string fconsutta [, array tparâmetros)) 


DB Common::quote() 


Acrescenta aspas a uma string para que possa ser usada de forma segura em 
uma consulta SQL. 


string DE::quote (string $string) 


DB Common::setFetchMode() 


Define o modo de busca pelos resultados de uma consulta. Para saber mais 
sobre esses modos, consulte o tópico “Modos de busca do resultado” deste 
capítulo. 


void setFetchMode (inteiro $modobusca [, string Sclasse.objeto = NULL]) 


Classe DB Result 


Contém o conjunto de resultados de uma consulta SQL. Alguns métodos da classe 
DB. Cormon irão retornar uma instância da classe DB. Result. 


DB Result::fetchinto() 


Busca uma linha e a armazena em uma variável, Para obter mais detalhes 
sobre esse método, consulte o item “Executando consultas SQL” do tópico 
sobre PEAR::DB deste capítulo. 


misto fetchInto (misto Sarr [, inteiro = $modobusca DB. FETCHMODE DEFAULT 
[, inteiro num Jinha = NULL]S) 
DB Result::fetchRow() 


Busca uma linha do resultado. O valor retornado depende do modo de busca 
especificado. Para obter mais detalhes sobre esse método, consulte o item 
“Executando consultas SQL” do tópico sobre PEAR::DB deste capítulo, 


misto fetchRow ([inteiro $modobusca = DB DEFAULT MODE [, inteiro $num. Tinha = NULL]]) 
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DB Result::free() 


Exclui o conjunto de resultados (result set) de uma consulta e libera a memória 
ocupada por este. 


boolean free O 


DB Result;:nextResult() 


Percorre conjuntos de resultados de diferentes consultas. É usado nos 
servidores de banco de dados que suportam a execução simultânea de mais 
de uma consulta, 


boolean nextResult () 


DB Result::tableinfo() 


Obtém informações da tabela sobre a qual foi feita a consulta. Retorna essas 
informações em um array associativo. 


misto tableinfo (recurso $resultado [, int fmodo = NULL]) 


DB Result::numtols() 


Retorna o número de colunas existentes nas linhas resultantes de uma 
consulta. 


inteiro numlols () 


DB Result;:numRows() 
Retorna o número de linhas resultantes de uma consulta. 


inteiro numRows O 


Capítulo 11 


Estudo de caso: controle de finanças 


Neste capítulo, você irá aprender a criar um sistema para controlar suas finanças uti- 
lizando o PHP Para a criação desse sistema, serão utilizados diversos conteúdos que 
foram abordados no decorrer deste livro, como validação de campos de formulários, 
manutenção de informações com cookies, criação de gráficos, geração de relatórios 
PDE, abstração de banco de dados e envio de e-mails. Dessa forma, você poderá 
praticar a aplicação dos conhecimentos adquiridos, tornando-se mais apto a lidar 
com esses recursos e, posteriormente, aplicá-los em seus próprios programas. 


Definição do sistema 


A idéia básica do sistema é possibilitar o controle de seu orçamento mensal, per- 
mitindo a você cadastrar o dinheiro que recebe (receitas) e o dinheiro que gasta 
(despesas). O sistema irá exibir também o saldo de cada mês, ou seja, a diferença 
entre as receitas e despesas. Dessa forma, você poderá visualizar melhor quanto 
dinheiro lhe sobra ao final do mês ou se está gastando mais do que ganha (saldo 
negativo). Para entender como será estruturado esse sistema, observe a figura 111, 


Nosso sistema será estruturado conforme essa planilha, ou seja, as receitas e 
despesas serão classificadas como fixas ou variáveis, de acordo com seu tipo. Veja a 
seguir o significado e alguns exemplos sobre cada um dos tipos: 


- Receitas fixas: é aquele dinheiro que você recebe todos os meses. Exemplos: 
salário, aluguéis (caso você tenha um imóvel e esteja alugando-o), direitos 
autorais, serviços de manutenção etc. 


=a Receitas variáveis: é aquele dinheiro que você não recebe todos os meses, Exem- 
plos: aulas particulares, serviços prestados eventualmente, premiações etc, 


=- Despesas fixas: são aquelas que você tem de pagar todos os meses. Exemplos: 
água, luz, telefone, academia etc. 
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« Despesasvariáveis:são aquelas que você não paga todos os meses. Exemplos: manu- 


tenção do veículo, conserto de eletrodomésticos e aparelhos eletrônicos etc. 


Receitas Variáveis 


Total Receitas 


Despesas Fixas 


Despesas Variáveis 


Total Despesas . 


Figura 11.1 — Planilha para o controle de finanças pessoais. 


Por exemplo, imagine um professor que recebe um salário de R$ 100000 e que, 
no mês de janeiro, ganhou R$ 25000 dando aulas particulares. O salário seria clas- 
sificado como uma receita fixa e as aulas particulares, como uma receita variável, já 


que esse professor só dá aulas particulares eventualmente. Em relação às despesas, 


vamos supor que ele teve os seguintes gastos no mês de janeiro: 
-= R$ 5000 de academia de ginástica; 
a R$ 4000 da conta de água; 
« R$ 5000 da conta do telefone celular; 
« R$80,00 de combustível do veículo; 
"= R$ 30000 de mensalidade de um curso que ele está fazendo; 
= R$ 8000 da conta de luz; 
- R$ 12000 de manutenção do veículo; 


« R$ 7000 do conserto da TV. 


Capítulo 11 « Estudo de caso: controle de finanças 419 


Entre essas despesas, classificaríamos as seis primeiras como despesas fixas. 
Lembre-se de que ser uma despesa fixa não significa que seu valor é fixo, mas sim 
que deve ser paga todos os meses. As duas últimas seriam despesas variáveis, visto 
que não é todo mês que o veículo precisa de manutenção ou que ocorre algum 
problema na televisão. 


Resumindo, no mês de janeiro esse professor ganhou R$1.25000 (salário + 
aulas particulares) e teve despesas no total de R$790,00 (soma das despesas fixas 
e variáveis). Subtraindo o total das despesas do total de receitas, teríamos o saldo 
final do mês: 


Saldo = Receitas — Despesas 
Saldo = R$ 1.25000 — R$ 79000 
Saldo = R$ 46000 


Portanto, no mês de janeiro o professor conseguiu pagar todas suas contas e ainda 
sobrou o valor de R$ 46000. Nesse exemplo, a planilha do sistema de controle de 
finanças seria preenchida conforme ilustra a figura 11.2. 


Abri 

R$100000] J 1 

E a 
Do 


Aula particulares R$ 250,00 
PO 


Combustivel 


O 
E=s 
Do 
ae] 
[Celular | R$50,00) u 
ES 
EE 
[luz Tt R$8000 | 


Despesas Variáveis 
R$120,00]. T J | 
Conserto da TV DR O O Jo So 
SS ET a 
Total Despesas { R$78000 go d J 
R$40,0) [o Tt 


| Figura 11.2 — Exemplo de preenchimento da planilha. 


l Para criar um sistema em PHP que permita esse controle de finanças, primeira- 
| mente será criada uma base de dados para armazenar as receitas e despesas, como 
mostra o próximo tópico. 
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Criando a base de dados 


A base de dados do sistema será formada por duas tabelas, sendo uma para arma- 
zenar as receitas e despesas e outra para armazenar as informações dos usuários 
(login e senha). Dessa forma, além de utilizar o sistema para controlar seu orça- 
mento, você poderá criar usuários novos, permitindo, por exemplo, a seus familiares, 
amigos ou usuários criar as próprias planilhas de controle de finanças utilizando 
o mesmo sistema. 


A tabela que irá armazenar as receitas e despesas, que será nomeada como 
receitas despesas, deverá possuir as seguintes informações: 


= descrição da receita/despesa; 

* tipo (receita fixa, receita variável, despesa fixa ou despesa variável); 
= data; 

-valor em R$; 

= nome do usuário ao qual ela pertence. 


A tabela que irá armazenar os usuários do sistema será nomeada como usuarios. 
autorizados e irá conter os nomes de usuários (usernames) e senhas autorizadas. No MySQL, 
por exemplo, essas tabelas seriam criadas da seguinte forma, no utilitário mysql: 


create table receitas despesas 


( 
id mediumint NOT NULL AUTO INCREMENT, 
usuario varchar(20) NOT NULL, 
descricao varchar(80) NOT NULL, 
tipo char(2) NOT NULL, 
data date NOT NULL, 
valor float NOT NULL, 
primary keyóid) 
J; 
create table usuarios autorizados 
£ 
usuario varchar(20) NOF NULL, 
senha varchar(20) NOT NULL, 
primary key(usuario) 
J; 


Inicialmente, você pode incluir, por exemplo, um usuário chamado padrao com 
senha padrao na tabela de usuários autorizados. Essa inclusão é feita com o comando 
INSERT, da seguinte forma: 


insert into usuarios autorizados values ('padrao', 'padrao'); 


Você pode inserir quantos usuários desejar, de acordo com a quantidade de 
pessoas que irá utilizar o sistema. 
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include de acesso ao banco de dados 


Como em várias páginas haverá necessidade de abrir a conexão com o banco de 
dados, o ideal seria criar uma include de acesso ao banco, para facilitar a manu- 
tenção e evitar a repetição desnecessária de código. Essa include será nomeada 
como conecta banco. inc € será chamada por todas as páginas que acessam o banco 


de dados. 


Visto que o objetivo desse estudo de caso é mostrar a aplicação dos conteúdos 
apresentados no decorrer do livro, o acesso será feito por meio da dbx, a extensão 
de abstração de bancos de dados explicada no Capítulo 10. Portanto, a include ficará 
da seguinte maneira: 


conecta banco.iné 


<?php 

/! configurações do banco de dados 
Sservidor = "localhost"; 
fusuario bd = "juliano"; 

$senha bd = "12345"; 

$banco = "test"; 


con = dbx connect ("mysql", $servidor, $banco, fusuario bd, Ssenha hd); 
?> 


Nessas quatro variáveis ($servidor, fusuario bd, Ssenha bd e $banco), você irá defi- 
nir as configurações de seu servidor de banco de dados. Em seguida, no primeiro 
parâmetro da função dbx.cmect, você deverá indicar qual SGBD pretende utilizar 
(ex.: “mysql"). 


Se você não quiser utilizar a extensão .dbx, terá de substituir os comandos referen- 
tes a ela pelos respectivos comandos do SGBD que estiver utilizando. Por exemplo, 
para acessar o banco de dados via comandos MySQL, você deverá fazer as seguintes 
substituições nos programas desse sistema: 


* usar mysql. connect (ou mysqli. comect) em vez de dbx comect; 
= usar mysql_query (ou mysqli query) em vez de dbx query; 


= usar mysql fetch row (ou mysqli fetch.row) em vez de obter os resultados no 
formato $res->data [Vinha] [coluna]. 


Nos exemplos disponíveis para download no site da Novatec Editora, encontra- 
se disponível também a versão baseada no MySQL. 
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Autenticação do usuário com cookies 


A primeira página do sistema será a de identificação do usuário, composta de um 
formulário HTML com os campos “Usuário” e “Senha” como mostra a figura 113. 


A 


+T? Controle de gastos mensais “ss: 


Digite seus dados de identificação para acessar o sistema: 


Figura 11,3 — Página de identificação do usuário. 


Dessa forma, só poderão acessar o sistema os usuários que você incluiu na ta- 
bela usuarios. autorizados, como mostrado no tópico anterior. O código dessa página 
inicial, que chamaremos de index.php, será o seguinte: 


index.php 


<html> 

<head> 

«title>Controle de gastos mensais</title> 

</head> 

<body> 

<h2 align="center"><font color="#00FF00">$$$</font> Controle de gastos mensais 

<font color="#00FF00">$$$</font></h2> 

<p align="center">Digite seus dados de identificação para acessar o sistema:</p> 

<hr> 

<form method="POST" action="Togin. php"> 
<p align="center">suário: <input type="text" name=“usuario" size="20"></p> 
<p atign="center">Senha: <input type="password" name="senha” size="20"></p> 
<p align="center"><input type="submit" value="Enviar” name="enviar"></p> 

</form> 

<hr> 

«</body> 

</html> 
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Lembre-se de que, conforme vimos no Capítulo 3, um sistema de username/senha 
é formado por três partes: 


1. Login: entrada do usuário no site. Nessa etapa são criados os cookies. 
2. Autenticação: verificação da existência e validade dos cookies. 
3. Logout: saída do sistema. Nessa etapa são excluídos os cookies. 


A seguir, veremos como implementar cada uma dessas partes. 


Login 


Note que após o usuário digitar seus dados de identificação na página index.php, 
estes são submetidos a um programa chamado login.php. Esse programa irá obter 
os dados enviados acessando o array superglobal $ POST, conforme vimos no Capi- 
tulo 2. Em seguida, é aberta uma conexão com o banco de dados para verificar a 
existência do usuário e a validade de sua senha. Acompanhe, então, como ficaria o 
código do programa lagin. php: 


login.php 


<?php 

// obtém os valores digitados 

Susuario = 5. POST[ usuario]; 

tsenha = $ POST[ "senha"; 

ff acesso ao banco de dados 

include "conecta banco. inc”; 

$res = dbx query(Scon, "SELECT * FROM usuarios autorizados where usuario='fusuario' 
and senha='$senha'"); 

$linhas = fres->rows; 

if ($linhas == 0) // testa se a consulta retornou algum registro 


{ 
echo "<html><body>"; 
echo "<p align=\"center\">0 login não foi realizado porque 05 dados digitados são 
inválidos. </p>" 
echo "<p align="center ><a href= "index. phpy">Voltar</a></p>"; 
echo "</body></html>"; 
} 
else 
1 
setcookie("usuario", Susuario); 
setcookie("senha”, Ssenha); 
header ("Location: principal.php"); // direciona para à página inicial dos usuários 
cadastrados 
} 


dbx_close($con); 
7> 
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Por meio de um comando SQL SELECT, testa-se se existe algum registro na tabela 
usuarios autorizados que coincida com os valores digitados. Se existir, o programa 
criará os cookies chamados usuario e senha e, logo depois, redirecionará o usuário 
para a página principal do site, que veremos mais adiante. 


Autenticação 


O próximo passo é criar o programa de autenticação dos usuários. Esse programa 
será incluído (por meio do comando include) no início de todas as páginas que fazem 
parte do sistema. Assim, evitamos que um usuário tente acessar diretamente uma 
página sem passar pelo login. 


Como vimos no Capítulo 3, um programa de autenticação deve verificar a existên- 
cia e validade dos cookies, pois se estes não existirem ou forem inválidos, significará 
que o usuário não se identificou e, portanto, não tem autorização para acessar o 
site. Por se tratar de um include, o programa será nomeado como valida cookies. inc. 
O código será apresentado a seguir: 


valida cookies.inc 


<?php 
if (IsSet(3 COOKIE["usuario"])) 
$usuario = $ COOKTE["usuario"]; 
if (IsSet(3 COOKIET" senha"])) 
fsenha = $ COOKIE["senha"]; 
if (! Cempty(fusuario) OR empty(Ssenha))) 


{ 
include "conecta banco. inc"; 
$res = dbx query($con, "SELECT * FROM usuarios. autorizados WHERE usuario='$usuario" and 
senha='$senha""3; 
if ($res->rows == 0) 
{ 
setcookie("usuario"); 
setcookie("senha"); 
echo "Você não efetuou o LOGIN!" : 
exit; 
} 
} 
else 
{ 
echo "Você não efetuou o LOGIN!"; 
exit; 
} 


dbx_close($con}; 
T> 
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Se os cookies existirem, esse programa fará uma consulta à tabela usuarios. 
autorizados por meio do comando SQL SELECT, para verificar se seus valores realmente 
conferem com os armazenados no banco de dados. 


Logout 


Para concluir o sistema de username/senha, basta criar o programa de logout, que 
irá excluir os cookies da máquina do usuário e redirecioná-lo à página inicial do 
site. Esse programa é bastante simples, como você pode ver no código apresentado 
a seguir: 


logout.php 


<?php 
setcookie("usuario"); 
setcookie("senha"); 
header C"Location: index.php"); 
7> 


Opções do menu principal 


Após fazer o login (por exemplo, com usuário padrao € senha padrao), o usuário será 
direcionado para a página principal do site, onde devemos exibir as opções dis- 
poníveis no sistema. Como estamos criando um sistema de controle de finanças, 
basicamente teremos opções para: 


= incluir receitas e despesas; 
- visualizar a planilha com os dados incluídos; 
= excluir receitas e despesas. 


Portanto, essa página principal deverá conter links que possibilitem a inclusão e 
exclusão de receitas fixas, receitas variáveis, despesas fixas e despesas variáveis, além 
de um link para a página de visualização da planilha que irá mostrar esses dados. 
A figura 114 mostra como essa página será exibida ao usuário. 


Veja que existem quatro links para a inclusão de receitas/ despesas. Porém, todos 
esses links vão referenciar o mesmo programa PHP Para indicarmos a esse progra- 
ma qual o tipo de receita/despesa que será incluído, vamos passar como parâmetro 
(pelo método GET) um dos seguintes códigos: 
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» RE para Receita Fixa; 
« RV para Receita Variável; 
" DF, para Despesa Fixa; 
* DV, para Despesa Variável. 


Para exclusão, por se tratar de uma operação mais simples, será necessário apenas 
um link. Portanto, acompanhe a seguir como ficará o código dessa página, que será 
nomeada como principal.php. Lembre-se de que em todas as páginas do sistema, a 
primeira tarefa a ser feita é incluir o script de autenticação valida cookies. inc criado 
anteriormente. 


e gastos mensaj 


Editar - T Favoritos 


[Enidereço JÆ] http:localhastifinancasiprincipel php 


Tf? Controle de gastos mensais S44 
Usuário: padrao 


Seja bem-vindo! Escolha a opção desejada: 


Incluir: 
Receitas fixas 
Receitas variáveis 
Despesas fixas 
Despesas variáveis 


Visualizar: 
Planilha de gastos mensais 


Excluir: 
Exchyr receitas e despesas 


Figura 11.4 — Às opções do menu principal. 
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principal.php 


<?php 

include "valida cookies. inc”; 

?> 

<html> 

<head> 

<title>Controle de gastos mensais</title> 

</head> 

<body> 

<h2 align="center"><font color=" #00FF00">$$$</font> Controle de gastos mensais 
<font color="#00FF00">$$$</font></h2> 

<p align="center">Usuário: <b><?php echo 3 COMKIE["usuario"]; 2></b></p> 

<p align="center">Seja bem-vindo! Escolha a opção desejada: </p> 

<hr> 

<p align="center"> 

<font size="4"><b>Incluir:</b><br> 

«a href="incluir.php?tipo=RF"><font size="4">Receitas fixas</font></a><br> 

«a href="incluir. php?tipo=Rv"><font size="4">Receitas variáveis</font></a><br> 

<a href="incluir.php?tipo-=DF"><font size="4">Despesas fixas</font></a><br> 

<a href="incluir.php?tipo=DV'><font size="4">Despesas variáveis</font></a><br> 

<!font></p> 

<p align="center"> 

<font size="4"><b>Visualizar:</b><br> 

<a href="periodo. php"><font size="4">Planilha de gastos mensais</font></a> 

</font></p> 

<p align="center"> 

<font size="4"><b>Excluir:</b><br> 

<a href="excluir.php"><font size="4">Excluir receitas e despesas</font></a><br> 

«/Tfont></p> 

<hr> 

<p align="center"><a href="10gout . php"><font size="3">Logout</font></a></p> 

</body> 

</html> 


Veja que no início da página foi exibido o nome do usuário (username), que 


atualmente está autenticado no sistema, Esse valor foi obtido por meio do array 
superglobal $ COOKIE: 


<?php echo $_COOKIE["usuario"]; ?> 


Pelo código, você já pôde ver que a página responsável pela inclusão de recei- 
tas/despesas se chamará incluir.php. Por parâmetro, passamos O tipo de receita ou 
despesa que será incluído. Por exemplo: 


incluir. php?tipo=RF 


Quanto à exclusão, o link aponta para a página excluir.php, que Irá apresentar a 
lista de receitas e despesas que poderão ser excluídas. O outro link, que leva o usuário 
à página de visualização da planilha, aponta para a página periado.php, que também 
veremos posteriormente. Essa página possui esse nome porque nela o usuário poderá 
escolher o período de visualização dos dados (meses inicial e final). 


428 PHP para quem conhece PHP 


Inclusão de receitas e despesas 


Para criar a parte de inclusão de dados, serão necessárias duas páginas: 


Página Descrição 

incluir.php Irá conter o formulário para a entrada de dados. 

gravar.php Irá receber as informações digitadas e gravá-las no banco de da- 
dos. 


Na página incluir.php, teremos um formulário com os seguintes campos: 


Campo Descrição 


Descrição Campo onde o usuário irá descrever a receita ou despesa. Ao lado desse 
campo, iremos exibir uma lista de seleção contendo as descrições já exis- 
tentes, caso o usuário opte por selecionar alguma em vez de digitá-la. 


Mês Mês no qual a receita ou despesa foi paga. 
Ano Ano no qual a receita ou despesa foi paga. 
Valor Valor em R$ da receita ou despesa. 


A figura 11.5 mostra como essa página será exibida ao usuário. 


soft Inte: 


| F% Controle de gastos mensais “SS 


Inclusão de RECEITAS FIXAS: 


Descrição: © Nova] a.. C Emistente: | Salário & 


Ano [E008 


Mês: | Jan di 


Figura 11.5 — Inclusão de receitas ou despesas. 


Veremos agora como será o código PHP dessa página. Esse código deverá avaliar 
o tipo passado como parâmetro (RF, RV, DF ou DV) e preencher a lista de descri- 
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ções já existentes, utilizando as descrições que pertençam a esse tipo e também ao 
usuário que está acessando o sistema. Lembre-se de que sempre obtemos o nome 
do usuário por meio do array superglobal $_C00KIE. 


Também será criada uma função de validação de dados com JavaScript, confor- 
me vimos no Capítulo 2. Essa função irá testar a validade dos campos descrição, 
ano e valor, antes que os dados sejam submetidos. Acompanhe, então, o código do 
programa a seguir: 


&s induir.php 


<?php 
include "valida cookies. inc”; 
usuario = 3. CO0KIE["usuario"]; 
$tipo = $_GET["tipo"]; 
if ($tipo == "RF") 
$titulo = "RECEITAS FIXAS"; 
elseif ($tipo == "RV") 
$titulo = "RECEITAS VARIÁVEIS"; 
elseif ($tipo == "DF") 
$titulo = "DESPESAS FIXAS"; 
elseif ($tipo == "D4") 
$titulo = "DESPESAS VARIÁVEIS"; 
T> 
<htal> 
<head> 
«title>Controle de gastos mensais«/title> 
«script Tanguage="javascript"> 
function valida dados (formulario) 


{ 
if (formulario. descricao_nova.value=="" && 
formulario. descricao[0].checked==true) { 
alert ("Você não digitou a descrição. "); 
return false; 
} 
if (formulario.ano.value. length<4) { 
alert ("Digite o ano com quatro digitos."); 
return false; 
k 
if Cformulario.valor.value=="") { 
alert ("Você não digitou o valor. "); 
return false; 
F 
return true; 
k 
</script> 
</head> 
<body> 


<h2 align="center"><font color="409FF00">$8$</font> Controle de gastos mensais 
<font color="#00FF00">$$$</font></h2> 
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<p align="center">Inclusão de <b><?php echo $titulo; 7></b>:</p> 

<hr> 

<form method="POST" action="gravar.php” name="formulario" 
onSubmit="return valida dados(this)"> 

<input type="hidden" name="tipo" value="<?php echo $tipo; 7>" checked> 

<p align="center"> 

Descrição: 

<input type="radio" name="descricao" value="nova” checked> 

Nova: <input type="text” name="descricao nova" size="20" 
onkeyDown="javascript:formulario.descricao[0]. checked=true"> 

<input type="radio" value="existente"” name="descricao"> Existente: 

«select size="1" name="descricao existente” 
onChange="javascript: formulario. descricao[1] .checked=true"> 

<?php 
// monta a lista das descrições já existentes para esse tipo 
include "conecta banco. inc”; 
$res = dbx query(Scon, “SELECT distinct(descricao) FROM receitas. despesas 

WHERE usuario="'Susuario" and tipo='Stipo" order by descricao"); 

$linhas = $res->rows; 
tor ($i = 0; $i < $linhas; $i++} 


{ 
$descricao = $res->data[$1][0]: 
echo "<option value=\"$descricao\">$descricao</option>"; 
} 
dbx close(fcon); 
?> 
</select> 
</p> 


<p align="center">Mês: <select size="1" name="mes"> 
<option value="1">Jan</option> 
<option value="2">Fev</option> 
«option value="3">Mar</option> 
<option value="4">Abr</option> 
<option value="5">Mai</option> 
<option value="6">Jun</option> 
<option value="7">Jul</option> 
<option value="8">Ago</option> 
«option value="9">Set</option> 
«option value="10">Qut</option> 
<option value="11">Nov</option> 
<option value="12">Dez</option> 
</select> 
Ano: <input type="text" name="ano" size="4" maxlength="4" 
value="<?php echo date("Y" time); ?>"> 
</p> 
<p align="cester">Valor: <input type="text" name="valor" size="10" maxlength="10"></p> 
<p align="center"><input type="submit" value=" Enviar" name="enviar"></p> 
</form> 
<hr> 
</body> 
</html> 
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Note que para o usuário optar entre uma nova descrição e uma já existente, há 
um botão do tipo “radio” ao lado de cada uma delas. Como muitas vezes o usuário 
se esquece de marcar esses botões, nesse programa foram utilizados dois eventos 
da HTML para marcá-los automaticamente. Por exemplo, se o usuário digitar uma 
nova descrição, mas esquecer-se de marcar o botão ao lado, poderemos marcá-lo 
de forma automática usando o evento onkeyDown: 


<input type="text" name="descricao nova” size="20" 
onkeyDown=" javascript: formulario. descricao[0] .checked=true"> 


Da mesma forma, se o usuário selecionar uma descrição já existente e esquecer-se 
de marcar o botão ao lado, poderemos marcá-lo usando o evento onChange: 


«select size="1" name="descricao existente” 
onChange="javascript: formulario. descricao[1] .checked=true”> 


Para a montagem da lista das descrições já existentes, executou-se uma con- 
sulta ao banco de dados com o comando SQL SELECT. Essa consulta retorna todos 
os registros que pertencem ao tipo especificado e ao usuário que está acessando o 
sistema: 


SELECT distinct(descricao) FROM receitas despesas WHERE usuario='Susuario' 
and tipo='$tipo' order by descricao 


Após o usuário preencher esse formulário da página incluir.php, OS dados serão 
enviados a um programa chamado gravar.php, que irá realizar a gravação das infor- 
mações no banco de dados. Como você pode ver no código apresentado a seguir, 
esse programa é bastante simples, visto que apenas obtém os dados por meio do 
array superglobal $ POST e os insere na tabela utilizando um comando SQL INSERT: 


gravar. php 


<?php 
include "valida cookies inc”; 
/! obtém os valores digitados 
tusuario = $ COOKIE["usuario"]; 
$tipo = $ POST["tipo"3; 
$descricao = 8 POST[" descricao"); 
mes = $ POST["mes"]; 
Sano = $. POST["ano“1]; 
&valor = 4 POSTI"valor"]; 
$data = "fano-fmes-01";  // data no formato do MySQL 
if (Sdescricao == “nova") 
nova descricao = $ POST[" descricao nova"); 
else 
$nova descricao = $ POST[" descricao existente"); 
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$comandoSQL = “insert into receitas despesas (usuario, descricao, tipo, data, valor) values "; 
$comandoSQL .= " ('Susuario!, '$nova descricao", '$tipo', '$data', $valor)"; 

/f acesso ao banco de dados 

include "conecta banco. inc"; 

fres = dbx query(fcon, $comandoSQL); 

echo "<html><body>": 

echo “<p align="center >Inclusão realizada com sucessol</p>"; 

echo "<p align=\"center\"><a href=4"incluir.php?tipo=StipoN">Incluir outra</a></p>"; 
echo "<p align=\"center\"><a href= "principal. phpy">Voltar</a></p>"; 

echo "</body></html>"; 


dbx close(fcon); 
?> 


Veja que para o campo de data, utilizou-se o formato do MySQL (AAA A-MM- 
DD). O ano e o mês são fornecidos pelo usuário. Para o dia, vamos considerar sempre 
o valor Ol, visto que essa informação é irrelevante em nosso sistema: 


fdata = "Sano-fmes-01": 


À planilha de receitas e despesas 


Para criar a planilha de visualização dos dados, serão utilizadas duas páginas: 


Página Descrição 

periodo. php Página onde o usuário irá selecionar as datas de início e de fim da 
planilha. 

ptanilha. php Página que irá exibir as receitas, despesas e o saldo final de cada 


mês que faz parte do período selecionado. 


A seguir serão apresentadas cada uma delas. 


Escolhendo o período de visualização 

Na página periodo.php, teremos um formulário com quatro campos: 
* mês e ano de início da planilha; 
* mês e ano de fim da planilha. 


Posteriormente, a página planilha.php irá mostrar as receitas e despesas referentes 
a todos os meses compreendidos entre essas duas datas. Veja na figura 116 como 
essa página será exibida ao usuário. 
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Escolha o periodo de visualização. 


Figura 11.6 — Escolhendo o período de visualização. 


O código para essa página é apresentado a seguir. Esse código é quase todo 
formado por tags HTML. O PHP foi usado apenas para autenticar O usuário no 
início da página e para preencher automaticamente o campo dos anos com o valor 
do ano atual: 


periodo.php 


<?php 

include "valida cookies inc”; 

T> 

<html> 

<head> 

«titlesControle de gastos mensais</title> 

</head> 

<body> 

<h? align="center"><font color="#00FF00">$$$</font> Controle de gastos mensais 
«font color="#00FF00">$$$</font></h2> 

<p align="center">Escolha o período de visualização: </p> 

<hr> 

<form method="POST" action="planilha.php"> 

<p align="center">Mês: <select size="1" name="mes"> 
<option value="01">Jan</option> 
<option value="02">Fev</option> 
<option value="03">Mar</option> 
<option value="04">Abr</option> 
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<option 
«option 
<option 
<option 
<option 
<option 
<option 
<option 
</select> 


Ano: <input type="text” name="ano" size="4" maxlength="4" 
value="<?php echo date("Y",time0); ?>"> 


</p> 


<p align= 


<option 
<option 
«option 
<option 
<option 
<option 
<option 
<option 
<option 
<option 
<option 
<option 
</select> 


value="05">Mai</option> 
value="06">]un</option> 
value="07">Jul</option> 
value="08">Ago</option> 
value="09">Set</option> 
value="10">Qut</option> 
value="1t">Nove/option> 
value="12">Dez</option> 


'center">até</p> 
<p align="center">Mês: «select size="1" name="mes2"> 


value="01">Jane/option> 
value="02">Fev</option> 
value="03">Mar</option> 
value="04">Abr</option> 
value="05">Mai</option> 
value="06">Jun</option> 
value="07">Jul</option 

value="08">Ago</option> 
value="09">Set</option> 
value="10">Out</option> 
value="11">Nov</option> 
value="12">Dez</option> 
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Ano: <input type="text" name="ano2" size="4" maxlength="4" value="<?php echo 
date("Y, time); ?>"> 


</p> 


<p align="center">&nbsp; <input type="submit" value="visualizar" name="ok"> </p> 
</form><hr> 
</body> 
<«fhtm)> 


Quando o usuário escolher o período de visualização e clicar o botão “Visualizar” 


é) 


será ativada a página planilha. php, apresentada no próximo tópico. 


Exibindo a planilha 


Veremos agora como funciona a principal parte do sistema: a planilha que exibe as 
receitas, despesas e o saldo de cada mês. A figura 11.7 mostra um exemplo de como 


essa planilha será exibida ao usuário. 
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Figura 11.7 — Visualizando as receitas e despesas do período escolhido. 


As receitas e despesas estão dispostas em uma tabela HTML, e cada coluna dessa 
tabela representa um mês do período escolhido. A planilha ainda exibe, para cada 
mês, três figuras que contêm um link para os seguintes programas (que veremos 
posteriormente): 


Programa Descrição 

gera grafico.php Gera um gráfico com as despesas do mês. 

gera. pof.php Gera um documento PDF com as despesas do mês. 
gera email.php Envia as despesas do mês para um e-mail, 


Vamos ver, então, como será o código dessa página apresentada na figura 1L7. 
Apesar de esse código ser um pouco extenso, seu entendimento não é tão complicado. 
Preste atenção aos comentários existentes no meio do programa para entender o 
que faz cada um dos principais trechos de programação PHP. 
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De forma resumida, a página planilha.php obtém todas as receitas e despesas do 
usuário atual que estejam dentro do período escolhido, armazenando-as em dife- 
rentes arrays. Utilizando arrays, torna-se mais fácil criar, posteriormente, um laço 
para a exibição das linhas da tabela HTML. Serão utilizados os seguintes arrays 
dentro do programa: 


" array datas para armazenar as datas, ou seja, os títulos das colunas da tabela 
HTML. 


-= SRF, SRV, SDF, $DV para armazenar, respectivamente, as descrições das receitas 
fixas, receitas variáveis, despesas fixas e despesas variáveis. Ou seja, esses 
arrays irão armazenar os títulos das linhas da tabela HTML. 


" Sreceitas fixas, freceitas variaveis, Sdespesas fixas e $despesas variaveis para armaze- 
nar os valores referentes a cada linha/coluna da tabela. Portanto, esses arrays 
terão duas dimensões. Por exemplo, para obter o salário do usuário no mês de 
janeiro de 2003, acessaríamos o elemento $receitas fixas["Salário"]["Jan-03"]. 


= Stotal receitas € Stotal despesas para armazenar, respectivamente, os valores 
totais de receitas e despesas em cada mês. 


Acompanhe, então, o código apresentado a seguir, prestando bastante atenção 
aos comentários: 


planilha.php 


<?php 

include "valida cookies, inc”; 

meses = array (“Jan", "Fev", "Mar", "Abr", "Mai", "Jun", "Jul", "Ago", "Set", "Out", "Nov", "Dez"); 
$usuario = $ COOKTE["usuario"); 

ff obtém os valores digitados 

Smes = $ POSTE" nes"); 

Sano = $. POST["ano"]; 

fmesz = 4 POSTI"mes2"]; 

Sano? = $ POST("ano2"]; 


ff colocar datas no formato AAA-MM-DD para consulta 
$data = "$ano-$mes-01"; 

fdata? = "$ano2-$mes2-01"; 

tarray datas = SRF = $RV = $DF = $DV = array); 


ff acessa o banco de dados e obtém os registros do usuário e do perido 

include "conecta banco. inc”; 

$comandoSQL = "SELECT descricao, tipo data, valor FROM receitas despesas ": 

$comandoSQL .= "WHERE usuario = '$usuario" and data >= 'Sdata' and data <= 'Sdata?! 
order by data, descricao"; 
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$res = dbx query($con, $comandoSQL); 
$linhas = $res->rows; 
if (Slinhas == 0) 


í 


echo "Não há receitas e despesas no período escolhido!"; 
exit; 


} 


else // coloca os dados em arrays 


{ 


for ($i = 0; $i < $linhas; $i++) 


{ 


$descricao = $res->data[$i] [0]; 
$tipo = $res->data[$i] E1]; 
tdata = $res->data[$i] [2]; 
$valor = $res->data[$1] [3]; 


JistlSano, $mes, $dia) = split("-", $data); 
$numero mes = Smes-1; 


fdata = meses [$numero mes) . "-" . fano; 
if (lin_array($data, $array_datas})} 
$array_datas[] = $data; 
if ($tipo == "RF") !! receita fixa 
{ 
if (lin_array($descricao, $RF)) 
SRF[] = Sdescricao; 
treceitas fixas[fdescricao] [$data] = Svalor; 
if (isset(ftotal receitas [Sdatal)) 
ttotal receitas[Sdata] += Svalor; 
else 
Stotal receitas[fdata] = fvalor; 
} 
elseif (ftipo == "RV"} 4i receita variável 
{ 
if Clin array(Sdescricao, $RV)}) 
$RV[] = Sdescricao; 
treceitas variaveis [Sdescricao] [$data] = $valor; 
if (isset(Stotal receitas [Sdata])) 
ttotal receitas[fdata] += valor; 
else 
Stota] receitas[Sdatal = fvalor; 
} 
elseif ($tipo == "DF") 4! despesa fixa 
{ 


if Clin array(Sdescricao, $DF)) 
$DF[] = $descricao; 
įdespesas_fixas[$descricao] [$data] = $valor; 
if Gsset($total_despesas[$data])) 
$total_despesas[$data] += $valor; 
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else 
Stotal despesas[Sdata] = $valor; 
} 
elseif (Stipo == "Dv") ff despesa variável 
{ 
if Clin array(fdescricao, $DV)) 
$DV[] = fdescricao; 
fdespesas variaveis[Sdescricao] [$data] = $valor; 
if (isset(Stotal despesas [tdata])) 
$total despesas[fdata] += $valor; 
else 
$total despesas [Sdata] = Svaler; 
} 
f 
} 
dbx_close{$con): 


$numero_colunas = sizeof(Sarray datas): 

Scolunas html = numero colunas+t; 

D 

<html> 

<head> 

<title>Controle de gastos mensais</title> 

</head> 

<body> 

<h2 align="center">Controle de gastos mensais</h2> 
«div align="center"> 


<center> 
<table border="1" celIspacing="0"> 
<tr> 
<td width="142">e/td> 
<?php 


ff exibe as datas 
foreach ($array datas as $data) 
echo “<td align=center” width=\"100\"><b><font color=" "40000801 ">Sdata 
<«/font></b></td>"; 
> 
</tr> 
<tr> 
<td colspan="<?php echo $colunas_html; ?>" bgcolor="#F5F5F5"> 
<b>RECEITAS FIXAS</b></td> 
</tr> 
<?php 
!f exibe as receitas fixas 
for {$i = 0; $i < sizeof(SRF); $i++) 
{ 
$descricao = SRF[Si]; 
echo "<tr><td width=\"142\">$descricao</td>": 
for ($j = 0; $j < $numero colunas; $j++) 
i 
$data = $array_datas [$j]; 
if (isset($receitas_fixas[$descricao] [fdata])) 
{ 
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$valor = $receitas. Fixas [Sdescricao] [$data] ; 
echo "<td aliga=" "center" width=\"100\">$valor</td>"; 


H 
else 
echo "<td align=\"center\" width="1001">&nbsp: nbsp; </td>", 
} 
echo "</tr>"; 
} 
T> 
<tr> 


<td colspan="<?php echo $colunas-html; ?>" bgcolor=" #F5F5F5"> 
<b>RECEITAS VARIÁVEIS</b></td> 

</tr> 
<?php 
/f exibe as receitas variáveis 
for ($i = 0; $i < sizeof($RV}; $i++) 
{ 

fdescricao = $RY[$1]; 

echo "<tr><td width=\"142\">$descricao</td>"; 


for ($j = 0; $j < $numero colunas; $j++) 
{ 
$data = Sarray datas[$jl; 
if (isset(Sreceitas variaveis [Sdescricao] [Sdatal)) 
{i 
valor = $receitas_variaveis[$descricao] [$data] ; 
echo "<td align "center\" width=\"100\">$valor</td>"; 
} 
else 
echo "<td align="center” width="100N">&nbsp; ênbsp; </td>"; 
} 
echo "</tr>"; 
} 
T> 
<tr> 
<td width="142" bgcolor="#D7FFFF"><b>Total Receitas:</b></td> 
<?php 
/! exibe o total de receitas 
foreach (Sarray datas as $data) 
{ 
if (isset(ftotal. receitas[Sdata])) 
$total = $total receitas[ídatal; 
else 
$total = 0; 
echo "<td align=\"center\" bgcolor=\"#D7FFFF\" width=\,"100\"> 
<b $total</b></td>"; 


«ftr> 
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<tr> 
<td colspane"<?php echo $colunas html; 7>" bgcolor="#F5F5F5"><b>DESPESAS FIXAS</b></td> 
</tr> 
<?php 
// exibe as despesas fixas 
for ($i = 0; $i < sizeof($DF); $i++) 


í 
fdescricao = $DF[$i]; 
echo "<tr><td width=\"142\">$descricao</td>"; 
for ($j = 0; $j < Snumero colunas; $j++} 
{ 
$data = $array_datas[$j]; 
if (isset($despesas_fixas[$descricao] [$data]}) 
{ 
$valor = $despesas_fixas[tdescricao] [$data] :; 
echo "etd align=\"center\" width=\"100\">$vator</td>"; 
} 
else 
echo "<td align="center" width=\"100\">8nbsp:&nbsp; </td>"; 
} 
echo "</tr>"; 
} 
?> 
<tr> 


<td colspan="<?php echo $colunas_html; ?>" bgcolor="#F5F5F5"> 
<b>DESPESAS VARIÁVEIS</b></td> 
</tr> 
<?php 
// exibe as despesas variáveis 
for ($i = 0; $i < sizeofc3DV); $i++) 


f 
descricao = SDV($i]; 
echo "<tr><td width=\"142\">$descricao</td>"; 
for ($j = 0; $j < $numero_colunas; $j++) 
{ 
$data = farray datas[$j]; 
if (isset(Sdespesas variaveis[Sdescricao] [fdata])) 
{ 
$vałor = Sdespesas variaveis [Sdescricao] [$data] ; 
echo “<td align="center” width=""100"stvalare/to>": 
} 
else 
echo “<td align=center” width=\"100\">8&nbsp;&nbsp: </td>"; 
} 
echo "</tr>"; 
} 
?> 
<tr> 


<td width="142" bgcolor="#FFE1E1"><b>Total Despesas: </b></td> 
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<?php 
!f exibe o total de despesas 
foreach (farray datas as $data) 
{ 
if Gsset($total_despesas[$datal)) 
$total = $total_despesas[$data]; 
else 
Stotal = 0; 
echo "<td align="center” bgcolor=""FFFELEIN” width=\"100\"> 
<b>$total</b></td>"; 
l 
7> 
</tr> 
<tr> 
<td width=" 142" ><b>GRÁFICO DESPESAS</b></td> 
<?php 
ji exibe o link para a geração do gráfico 
foreach (Sarray datas as fdata) 


í 
if (isset(ftotal despesas [data])) 
echo "<td align="center” width=\"100\"> 
«a href=\"gera_grafico.php?data=$data\"> 
<img src=ħ\"grafico.gif\" horder=V"0V></a></td>"; 
else 
echo "<td align="center width=\"100\">-</td>"; 
} 
7> 
</tr> 
<tr> 
<td width="142"><b>PDF DESPESAS</b></td> 
<?php 


!! exibe o link para a geração do PDF 
foreach (Sarray datas as $data) 
{ 
if (isset($total_despesas[$data])) 
echo "<td align="center” width=\"100\"> 
<a href=\"gera_pdf.php?data=$data\ "> 
<img src=\ pdf. gifi" border=\"0\"></a></td>"; 
else 
echo "<td align=center” width=\"100\">-</td>"; 
} 
> 
</tr> 
<tr> 
etd width="142"><b>E-MAIL DESPESAS</b></td> 
<?php 
ff exibe o link para o envio do e-mail 
foreach (Sarray datas as $data) 
i 
if (isset($total_despesas[$data])) 
echo "<td align=\"center\" width=\"100\"> 
<a href=V'gera email .php?data=$data\"> 
<img src=\"email.gif\" border=\"0\"></aæ</td>"; 
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else 
echo "<td align=center" width=\"100\">-</td>"; 

} 
?> 
</tr> 
<tr> 

<td width="142" bgcolor=" #CCFFCC"><b>SALD0</b></ td> 
<?php 


ff exibe o saldo (AZUL positivo, VERMELHO negativo) 
foreach ($farray datas as data) 


{ 
$saldo = 0; 
if Cisset(Stotal receitas[fdatal)) 
Ssaldo += Stotal receitas fdata]: 
if (isset(ftotal. despesas [Sdata])) 
saldo -= $total. despesas [$data]; 
if ($saldo < 0) 
$cor = "#FF0000"; ff vermelho 
else 
fcor = "#0000FF": /f azul 
echo "<td align="center” bgcolor="ECFECO” width" 100'> 
«font color="Scory"> 
<b>Ssaldo</b></font></td>"; 
} 
?> 
</tr> 
</table> 
</center> 
</div> 
<p align="center"><a href="principal .php">Voltar</a></p> 
</body> 
</html> 


À partir do próximo tópico, veremos como aplicar os conhecimentos adquiridos 
nos Capítulos 5, 7 e 8 deste livro em nosso sistema de controle de finanças. 


Gerando um gráfico de despesas 


O gráfico em formato de pizza, que estudamos no Capítulo 7, é ideal para represen- 
tar a distribuição das despesas de um mês. Considerando o exemplo do professor, 
apresentado no início deste capítulo, teríamos para o mês de janeiro de 2008 um 
gráfico dividido em “Academia”, “Água” “Celular”, “Combustível” “Cursos” “Luz” 
“Manutenção do veículo” e “Conserto da TV” como mostra a figura 11.8. 
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3 Totál despesas: R$790 


NE | Acaitenia 
{in gua -> 
| EB celular , 
-| O Eonbustivel 
O Cursos 
[E ruz 
E Conserto da TY 


E Hanutenção do veículo 


Figura 11.8 — Gráfico de despesas do mês. 


O que faremos aqui é apenas adaptar o programa que vimos no Capítulo 7, para 
que possa ser integrado em nosso sistema de controle de finanças. Por essa razão, para 
explicações mais detalhadas sobre a geração de gráficos, consulte o Capítulo 7. 


Acompanhe, então, o código do programa responsável pela geração do gráfico, 
o gera grafico.php, e logo a seguir as explicações. Lembre-se de que esse programa é 
ativado por meio de um link localizado na planilha principal e recebe o parâmetro 
“data” que contém o mês e ano do qual serão obtidas as despesas: 


gera. grafico.php 


<?php 

include "valida cookies .inc' 

header ("Content-type: image/png"); 

Susuario = & CODKIET"usuario"]; 

Edata = $ GETI"data"]; 

imeses = array ("Jan" Fev", Mar Abro, Maio, "Jun", "Jul", "Ago", "Set", "Out", "Nov", "Dez" ; 
TistóSmes, ano) = split("-", $data); 

{mes = array search(fmes, Smeses)+1, 

$data buscar = "Sano-$mes-01"; 

4! inclui o arquivo com as configurações 

include 'config grafico. inc”; 

{F cria imagem e define as cores 

Simagem = ImageCreate(Slargura, taltura); 

$fundo = ImageColorallocate(fimagem, 236, 226, 226); 
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fpreto = ImageColorATiocate(Simagem, 0, O, 0); 
Zazul = ImageColorANIocate(Simagem, O, O, 255); 
fverde = ImageColorATIocate(Simagem, O, 255, 0); 
fvermelho = ImageColorATIocate(fimagem, 255, 0, 0); 
Samarelo = ImageColorATIocate(Simagem, 255, 255, 0); 
Slaranja = ImageColorATIocate(Simagem, 255, 153, 0); 
Imagenta = ImagelolorANocate(Simagem, 255, 128, 255); 
fciano = ImageColorAllocate(Simagem, 128, 255, 255); 
Sverde escuro = ImageColorATiocate(Simagem, O, 128, 0); 
$cinza = InageColorATIocate(Simagem, 192, 192, 192); 
Scores = array (Sazul, jverde, Svermelho, Samarelo, $flaranja, fmagenta, $ciano, 
Sverde escuro, Scinza); 
/f definição dos dados 
include “conecta banco. inc”; 
$res = dbx query(Scon, “select descricao,valor from receitas despesas 
where usuario='$usuario' and data='$data buscar" and (xipo='DF" or tipo='DV')'9: 
$num linhas = fres-srows; 
for {$i = 0; $i < $num linhas; $i++) 
{ 
fdados[] = $res->data[$i] [0]; 
$valores[] = $res->data[$1] f1]; 
} 
dbx close($con); 
¿i cálculo do total 
Stotal = 0; 
$num linhas = sizeof(Sdados); 
for ($i = 0; $i < $num linhas; $i++) 
$total += fvalores[$i]; 
!f desenha o gráfico 
ImageEllipse (fimagem, Ícentrox, $centroy, Sdiametro, $diametro, $preto): 
ImageString(Simagem, 3, 3, 3, “Total despesas: R\$$total", $preto); 
Sraio = fdiametro / 2; 
for ($i = 0; $i < $num linhas; $i++) 
{ 


percentual = (tvalores[$1] / $total) * 100; 

$percentual = number_format($percentual, 2); 

fpercentual .= "#"; 

val = 360 * (Svalores[$i] / $total}); 

fangulo += $val; 

fangulo meio = Sangulo - ($val / 2); 

fx final = Scentrox + $raio * cos(degirad(Sangulo)); 

fy final = $centroy + (- $raio * sintdeg2rad(Sangulo))); 

fxmeio = fcentrox + (Sraio/2 * cos(degZrad(Sangulo meio))); 

ty meio = $centroy + (- $raio/2 * sin(degirad(Sangulo meio))): 

fx texto = Scentrox + (Sraio * cos(deg2rad(Sangulo meio))) * 1.2; 
$y_texto = Scentroy + (- $raio * sinideg2rad(Sangulo meio))) * 1.2; 
ImageLine(Simagem, Scentrox, Scentroy, $x final, $y final, Spreto); 
ImageFillToBorder(Simagem, fx meio, Sy meio, Spreto, Scores[figsizeof(fcores)D; 
InageString(Simagem, 2, 9x texto, $y texto, fpercentual, Spreto); 
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ff as*** CRIAÇÃO DA LEGENDA **2** 
if (Sexibir legenda == “sim") 


{ 


} 


¿í acha a maior string 
fmaior. tamanho = 0; 
for ($i = 0: $i < num linhas; $i++) 
if (strlen(fdados[$1]) > maior tamanho) 
maior tamanho = strlen(fdados[$1)); 
44 calcula os pontos de início e fim do quadrado 
ixcinicio legenda = $1x - $largura fonte * ($maior_tamanho+4); 
Syinicio legenda = $1y; 
4x fim legenda = Six; 
%y fim legenda = $ly + Snumlinhas * (Saltura fonte + Sespaco entre linhas) 
+ 2*Smargem vertical; 
ImageRectangle(Sinagen, $x. inicio legenda, $y-inicio legenda, $x fim legenda, 
$y fim legenda, Spreto); 
!! começa a desenhar os dados 
for ($i = 0; $i<fnum Vinhas; $i++) 
{ 
ix pos = $x inicio. legenda + flargura fonte*3; 
$y pos = fy inicio legenda + $i * CSaltura fonte + Sespaco entre linhas) 
+ fmargem vertical; 
Imagastring(Simagem, bfonte, x pos, Sy- pos, $dados[$1], Spreto); 
ImageFi VedRectangle (Simagen, ix pos-2*$largura fonte, $y- pos, 
&x pos-flargura fonte, £y possfaltura fonte, Scores[Siusizeof(fcores))); 


ImageRectangle ($imagem, $x pos-2*$largura fonte, $y_pos, ix pos-Slargura fonte, 


%y pos+taltura fonte, $preto); 


} 


ImagePng($imagem); 
ImageDestroy($imagem) ; 


7> 
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Esse programa recebe da página da planilha o parâmetro “data? Como esse 
parâmetro é passado por meio da URL (método GET), temos de obter seu valor por 


meio do array $.GET: 


$data = É GET["data"l; 


Em seguida, essa data que foi recebida no formato MÉS-ANO (ex.: Jan-2003) 
é separada em duas variáveis diferentes, uma para o mês e outra para o ano. Para 


isso, utilizou-se a função split: 


Vist(fnes, Sano) = sphit("-", fdata); 


Com o nome do mês (ex.: Jan”), podemos obter o número equivalente a este 


utilizando a função array. search. Essa função fará uma busca no array dos meses € 
irá retornar o índice equivalente ao mês buscado. Como no PHP os índices iniciam 


em 0, devemos somar 1 a esse valor: 


Smes = array search(Smes, meses) + 1; 
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De posse do número do mês, podemos montar a data da qual buscaremos as 
despesas no banco de dados: 


Sdata buscar = "fano-fmes-01": 


Veja que, no momento da consulta ao banco de dados, obtemos somente os 
registros que são do tipo “DF” (despesa fixa) ou “DV” (despesa variável), pois nesse 
caso estamos gerando um gráfico somente de despesas: 


$res = dbx query(Scon, "select descricao, valor from receitas despesas 
where usuario='Susuario' and data='$data buscar" and (tipo='DF' or tipo='DV')"); 


Observe também que como estamos utilizando a extensão .dbx para implementar 
abstração de banco de dados, os resultados da consulta foram atribuídos aos arrays $dados 
e $valores de acordo com a sintaxe dessa extensão, em vez de usar funções do MySQL: 


$dados[] = $res->data[$i][0]; 
$valores[] = $res->data[ti] [1]; 


O restante do programa é praticamente o mesmo que foi apresentado no Ca- 
pítulo 7. Como você pôde ver, no gera grafico. php foram acrescentadas apenas mais 
algumas cores no início do programa com a função InageColorATocate, já que nesse 
exemplo temos uma quantidade maior de divisões. 


Gerando um relatório PDF para o mês 


Outra característica de nosso sistema de controle de finanças é a possibilidade de 
gerar um documento PDF listando as despesas de um determinado mês, Por exemplo, 
para o caso do professor apresentado no início deste capítulo, a figura 119 mostra 
o documento PDF que teríamos para o mês de janeiro de 2008. 


A idéia é aproveitar o programa que vimos no Capítulo 8, no tópico “Relatórios 
PDF a partir de consultas SQL”, fazendo as adaptações necessárias para que seja 
integrado a esse sistema, Por essa razão, para explicações mais detalhadas sobre a 
criação de documentos PDF, consulte o Capítulo 8. 
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drtimnesetaã 


Lista de despesas - Jan-2008 (página 1) 
Descrição Valer (RS) 
Academia so 
Agua 40 
Celular so 
Combustivel so 
70 
30 


2 
Mumtenção do veiculo 120 


Figura 11.9 — Documento PDF contendo a lista de despesas. 


Acompanhe, então, o código do programa responsável pela criação do documen- 
to, o gera pdf .php, e logo a seguir as explicações. Lembre-se de que esse programa é 
ativado por meio de um link localizado na planilha principal e recebe o parâmetro 
“data”, que contém o mês e ano do qual serão obtidas as despesas: 


gera pdf.php 


<?php 

include 'valida cookies. inc”; 

Ff eee CONFIGURAÇÕES DO PROGRAMA “ERRIRS*A 
ff documento 

$largura = 842; 

taltura = 595; 

Smargem vertical = 30; 

Smargem. horizontal = 30; 

Stamanho fonte = 14; 

$tamanho fonte titulo = 20; 


!! obtén o valor do cookie e do parâmetro 
Susuario = $£ COMIE[“usuario"]; 

$data = $ GET" data"]; 

$titulo = "Lista de despesas - $data"; 
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!f monta a data para busca no banco de dados 

meses = array ("Jan”,"Fev", "Mar" "Abr" "Mai", "Jun", "Jul, "Ago", "Set", "Out", “Nov”, Dez”); 
JistíSmes, Sano) = split("-" $data); 

fmes = array searchíimes, jmeses) + 1; 

êdata buscar = "Sano-$mes-01"; 


!! consulta SQL que irá gerar o relatório 

&consulta = “select descricao,valor from receitas despesas 
where usuario='Susuario" and data='$data buscar" and (tipo='DF' or tipo='DV') 
order by descricao”; 

Scolunas resultantes = array ("descricao”, "valor"); 


// tabela a ser gerada no PDF 
ftexto. colunas = array ("Descrição", "Valor (R\$)"); 
Slargura coluna = array (200, 70): 


// executa a consulta 

include “conecta banco. inc"; 

$result = dbx query(Scon, Sconsulta); 
Stotal = Sresult->rows; 


if CStotal == 0) 


{ 
dbx_close{$con}; 
echo "O relatório não foi gerado porque a consulta não retornou registros!"; 
exit; 

} 


/f cria o documento PDF 

$p = new PDFIIDO); 

if CSp->begin document("", "") == 0) { 
die("Erro: " . Sp->get errmsgÓ); 

} 


!! cálculos 

Saltura celula = ftamanho fontes3; 

Saltura titulo = $tamanho fonte titulo+3; 

Saltura tabela = faltura - 2*$fmargem vertical; 

$linhas. por pagina = intval ((faltura tabela-Saltura titulo)/Saltura celula)-1; 
ff tirar 1 devido ao cabeçalho 

$num paginas = ceil(Stotal/$Slinhas por pagina); 

$linha atual = 0; 


/! gera as páginas 
for ($i = 0; $i < $num paginas; $i++) 
{ 
ff cria nova página 
$p->begin page ext(Slargura, Saltura, "9; 
ff título do relatório 
$font = $p->10ad font("Times-Bold”, "winansi", "9; 
tp->setfont(Sfont, Stamanho fonte titulo); 
fposy = $altura - $margem vertical; 
$posx = fmargem horizontal; 
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Spag atual = $i+1; 

Sp->show xy(Stitulo.” (página fpag atual)", Sposx, fposy); 
ff cria o cabeçalho da tabela em negrito 

Sfont = $p->load font("Times-Bold", "winansi”, ""); 
Sp->setfont(Sfont, Stamanho fonte); 

$posy -= faltura titulo; 

$posx = Smargem horizontal; 

$p->moveto(Sposx, $posy-3); 
$p->lineto($Slargura-fmargem horizontal, $posy-3); 
Sp->stroke() ; 

for ($k = 0; $k < sizeoF(Stexto colunas); $k++) 


{ 
fp->show_xy($texto_colunas[$k], $posx, Sposy); 
$posx += $largura_coluna[$k]; 

} 

ff tira o negrito da fonte 

$font = 3p->10ad font("Times-Roman”, "winansi", "9: 


4p->setfont(tfont, $tamanho fonte); 
// escreve os registros 
$inicio = $linha_atual; 
$fim = $linha atual + $linhas_por_pagina; 
if ($fim > $total) 
fim = $total; 
for {$j = $inicio; $j < $fim; $j++) 
{I 
$linha_atual = $j; 
$posx = fmargem horizontal; 
$posy -= $altura celula; 
for ($k = 0: $k < sizeof(fcolunas resultantes); $k++} 
{ 
$valor = $result->data[$linha_atual] [$colunas_resultantes[$k]]; 
$p->show_xy($valor, $posx, $posy); 
$posx += $largura coluna[$k]; 
k 
Slinha atual; 
} 
/f encerra a página 
Sp->end page ext(""); 
} 


dbx close(fcon); 


ff encerra o documento PDF 

$p->set. parameter ("openaction"”, "fitpage"); 

$p->end document (""3; 

Sbuf = $p->get. bufferQO; 

Stamanho = strien($buf); 

header("Content-type: application/pdf"); 
header("Content-Length: Stamanho"); 
header("Content-Disposition:inline; filename=relatorio. pdf"); 


echo $buf; 
?> 
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Esse programa recebe da página da planilha o parâmetro “data” Esse parâmetro, 
obtido pelo método GET, foi separado em duas variáveis (mês e ano), assim como foi 
feito no programa do tópico anterior para a geração de gráficos: 


listCSmes,Sano) = split("-", fdata); 


Dessa forma, podemos encontrar o número correspondente a esse mês fazendo 
uma busca no array de meses e, posteriormente, montar a data a ser buscada no 
banco de dados, utilizando o formato AAAA-MM-DD. Se seu SGBD usa outro 
formato, você pode alterar a variável $data buscar: 


fmes = array search(Smes, fmeses) + 1; 
fdata buscar = "fano-$mes-01"; 


Veja que, no momento da consulta ao banco de dados, obtemos somente os 
registros que são do tipo “DF” (despesa fixa) ou “DV” (despesa variável), pois nesse 
caso estamos gerando um documento somente de despesas: 


Sconsulta = "select descricao, valor from receitas despesas where usuario='Susuario' 
and data='Sdata buscar" and (tipo='DF" or tipo='DV') order by descricao"; 


Conforme explicado no Capítulo 8, devemos ajustar os três arrays do programa 
que definem como as colunas serão desenhadas no documento. Como essa con- 
sulta irá retornar duas colunas (descrição e valor), iremos configurar os arrays da 
seguinte forma: 


fcolunas. resultantes = array ("descricao”, “valor"); 
ftexto colunas = array ("Descrição”, “Valor (R$); 
&largura coluna = array (200, 70); 


Isso significa que a primeira coluna do documento irá exibir os valores do 
campo “descricao” e a segunda coluna, os valores do campo “valor” do banco de 
dados. O array $texto colunas contém os textos que devem ser exibidos como título 
de cada coluna. E no último array são definidas as larguras das duas colunas no 
documento PDF. 


Observe também que como estamos utilizando a extensão .dbx para implementar 
abstração de banco de dados, os resultados da consulta foram obtidos de acordo 
com a sintaxe dessa extensão, em vez de usar funções do MySQL: 


fvalor = $result->data[$linha atual] [$colunas resultantes [$k]]; 


O restante do programa é praticamente o mesmo que foi apresentado no Ca- 
pítulo 8. 
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Enviando os dados por e-mail 


Para colocarmos em prática os conhecimentos adquiridos no Capítulo 5, nosso 
sistema de controle de finanças irá permitir também o envio das despesas do mês 
para um determinado endereço de correio eletrônico. 


A página que irá enviar os e-mails será chamada de gera email.php e, assim como 
os programas de geração de gráficos e documentos PDF, também recebe (pelo 
método GET) o parâmetro “data” contendo o mês e o ano do qual as despesas serão 
obtidas. Quando essa página for acessada, primeiramente deverá solicitar ao usu- 


ário a digitação do e-mail para o qual as despesas serão enviadas, como mostra a 
figura 11.10. 


Figura 11.10 — Enviando as despesas por e-mail, 


Após o usuário preencher o e-mail e clicar o botão “Enviar” essa informação será 
enviada para essa mesma página, que deverá obter as despesas do mês, colocá-las 
em forma de uma mensagem e enviá-las ao e-mail especificado. 


Portanto, o primeiro teste que essa página deve fazer é se o campo “email” foi 
recebido. O comando isset do PHP pode ser utilizado para testar se essa variável 
está definida. Se não estiver (primeiro acesso), o programa exibirá o formulário para 
a digitação do e-mail. Caso contrário, obterá as despesas e as enviará para o e-mail 
fornecido. Acompanhe, então, o código apresentado a seguir: 


gera email.php 


<?php 
include 'valida cookies. inc"; 
if (Uisset(s POST["email"])) 
{ 
$data = $_GET["data"]; 
echo "<html><body>"; 
echo "<form method=\ "POSTA" action=\ "gera email. php\">"; 
echo "<input type=\"hidden\" name=\"data\" value=\"$data\">": 
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echo "Seu e-mail: <input type=" "text" names email" size=\"30\">"; 
echo " <input type=" "submit" nane=\"enviar\" values\"Ẹnaviar\">"; 
echo "</form>"; 
echo "</body></html>": 
} 
else 
{ 
$email = $_POST["emait"]; 
if (strlen($email) < 8 || substr count(Semail, "@") !=1 Il 
substr_count($email, ".") == 0) 
echo "O e-mail digitado é inválido! "; 
else 
{ 
$usuario = $_COOKIE["usuario"]; 
$data = $. POST["data"]; 
jmeses = array ("Jan", "Fev", "Mar", "Abr", "Mai", "Jun", "Jul", "Ago", "Set", 
"Out", "Nov", "Dez"; 
VistCfmes,fano) = split("-", $data); 
fmes = array search(Smes, Smeses)+1; 
data buscar = "Sano-$mes-01"; 
ft! — definição dos dados -- 
include "conecta banco.inc"; 
$res = dbx query($con, "select descriçao,valor from receitas despesas 
where usuario='fusuario' and data="Sdata buscar" and (tipo='DF' or tipo='DV) 
order by descricao"); 
$num linhas = $res->rows; 
for (ți = 0; $i < $num linhas; $i++) 
{ 
$descricoes[] = $ras->data[$i) [0]; 
Svalores[] = $res->data[$i} [1]; 
} 
dbx.close($con); 
/! - cálculo do total -- 
ftotal = 0; 
fnum linhas = sizeof(Sdescricoes); 
for ($i = 0; $i < Snum linhas; $i++) 
Stotal += $valores[$i]; 
/f - monta a mensagem e manda o e-mail —- 
$msg = "Lista de despesas - $data\n\n"; 
for ($i = 0; $i < $num linhas; $i++} 
{ 
$descricao = $descricoes[$i}; 
$valor = $valores[$1]; 
$msg .= "$descricao - R\$3valor\n"; 
i 
$msg .= "\nTotal de despesas: R\$$total"; 
mail(temail, "Despesas de $data", $msg); 
echo "As despesas de $data foram enviadas para o.e-mail especificado. "; 


Capítulo 11 a Estudo de caso: controle de finanças 453 


Note que, no primeiro acesso, o programa exibe o formulário para o usuário 
digitar o e-mail destino. Esse formulário deve possuir ainda um campo escondido 
(tipo “hidden”) para passar adiante a data que recebeu pelo método GET: 


echo "<input type=\"hidden\" name=Vdatal” value=\"$data\">"; 


Portanto, haverá dois campos no formulário: um para a digitação do e-mail 
e outro escondido contendo a data. Ao clicar o botão “Enviar” os valores desses 
campos serão submetidos novamente a essa mesma página, que deverá realizar o 
envio do e-mail. 


Conforme estudamos no Capítulo 2, é importante aplicar uma validação sobre o 
campo de e-mail. Nesse exemplo, testou-se se o e-mail digitado possuía pelo menos 
8 caracteres, uma única arroba e pelo menos um ponto: 


if (strlen(Semail) < 8 |] substr count(Semail, "@"} != 1 || substr countCgemail, ".") = 0) 
echo "O e-mail digitado é inválido! *; 


Em seguida, a consulta feita ao banco de dados para obtenção das despesas foi 
exatamente a mesma realizada nos programas dos tópicos anteriores sobre geração 
de gráficos e documentos PDF: 


$res = dbx query(Scon, "select descricao, valor from receitas despesas 
where usuario='fusuario" and data='$data buscar" and (tipo='DF' or tipo='Dv') 
order by descricao"); 


Após obter os registros e armazená-los em dois arrays (fdescricoes e Svalores), 
criou-se um laço com o comando for, onde a cada iteração uma despesa e seu res- 
pectivo valor são concatenados à variável $msg, que consiste na mensagem que será 
enviada por e-mail: 


$descricao = $descricoes [$i]; 
Svalor = $valores[$i]; 
$msg .= "Sdescricao - R\$$valor\n"; 


Veja que o primeiro “$” é precedido por uma barra invertida, pois nesse caso 
queremos que esse caractere faça parte da mensagem e não seja interpretado como 
uma variável. O “n” acrescentado ao final da string serve para separar as despesas 
com uma quebra de linha. Por fim, a mensagem é enviada para o e-mail digitado 
pelo usuário, por meio da função mail do PHP: 


mail($email, "Despesas de $data", $msg); 


Lembre-se de que o programa gera email.php irá funcionar somente se seu sistema 
operacional tiver o programa de envio de e-mails instalado (ex.: Sendmail). 
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Exclusão dos dados cadastrados 


Para criar a parte de exclusão de dados, serão necessárias duas páginas: 


Página Descrição 
excluir. php Irá exibir a lista de todas as receitas e despesas pertencentes ao 
usuário atual, com um link “Excluir” ao lado de cada uma delas. 


elimina. php É a página que realiza a exclusão. É ativada pela página excluir. 
php, que lhe passa como parâmetro o identificador do registro a ser 
excluído no banco de dados. 


Na página excluir.php, será aberta uma conexão com o banco de dados e serão 
obtidos, em ordem decrescente de data, todos os registros pertencentes ao usuário 
atual. Para cada um deles será exibido um link que permitirá sua exclusão. Por 
exemplo, para o registro que possui o identificador 1, o link será: 


<a href="elimina.php?id=1">Excluir</a> 


Acompanhe, então, o código dessa página que irá listar todas as receitas e des- 
pesas que poderão ser excluídas: 


excluir. php 


<html> 

<body> 

<h2 align="center">Exclusão de registros</h2> 

<?php 

include "valida cookies. inc”; 

Susuario = 5 COOKIE["usuario"]; 

fmeses = array ("Jan", "Fev", "Mar", "Abr", "Mai", "Jun", "Jul", "Ago", "Set", "Out", "Nov", "Dez"); 

// obtém todos os registros do usuário 

include "conecta banco. inc”; 

$res = dbx query(fcon, "select id, descricao, data, valor from receitas despesas 
where usuario='S$usuario' order by data desc"); 

tnum linhas = $res->rows; 

for ($i = 0; $i < $num linhas; $i++) 


{ 
Sid = $res->data[$i] [0]; 
descricao = $res->data[$i] (11: 
$data = $res->dataf$i] [2]; 
Svalor = S$res->data[$9] [3]; 
Vist(Sano, fmes, ídia) = split("-",Sdata); 
Snome mes = $mesesf$mes-1]; 
echo "gnome mes/$ano - $descricao (RiS$valor) "; 
echo "<a href=""elimina, php?id=Sid">Excluir</a><br>"; 
k 
dbx close(fcon); 
?> 
</body> 


</html> 
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A figura ILL mostra um exemplo de saída que pode ser produzida pelo programa 


excluir.php. 


EE ndéreço. E] http: /localhost/financasjexduir.php 


Exclusão de registros 


| Fev'2008 - Conserto do DVD (R$100) Excluir 
À Fev/2008 - Cursos (R$400) Excluir 
| Fev/2008 - Celular (R$53) Excluir 
| Fev/2008 - Água (R$40) Excluir 
Fevi2008 - Luz (R$45) Excluir 
Fev/2008 - Academia (R$60) Excluir 
| Fev/2008 - Salário (R$ 1500) Ezchur 
À Few2008 - Combustível (R$20) Excluir 
À Jan/2008 - Conserto da TV (R$70) Excluir 
À Janf2008 - Luz (R$80) Excluir 
J Jan'2008 - Manutenção do veiculo (R$120) Exchsr 
| Jan/2008 - Cursos (R$300) Excluir 
4 Jay2008 - Combustivel (R$80) Excluir 


Figura 11.11 — Lista para exclusão de receitas e despesas. 


Veja que para gerar essa lista foi necessário obter quatro colunas da tabela de 
receitas e despesas: “id” “descricao” “data” e “valor”: 


$res = dbx querv($con, "select id, descricao data,valor from receitas despesas 
where usuario='$usuario" order by data desc"); 


A primeira coluna (id) foi utilizada apenas para passar o identificador do registro 
como parâmetro ao programa que fará a exclusão deste. Quanto à coluna “data”, o 
ano, mês € dia foram armazenados em três variáveis diferentes: 


HistCSano, mes, fdia) = split("-", $data); 


O valor da variável $mes foi utilizado como índice para buscar o respectivo nome 
no array dos meses, definido no início do programa: 


Gnome mes = fmeses[fmes-1]; 
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De posse dos nomes do mês, do ano, da descrição e do valor do registro, basta 
exibi-los na tela, com um link que permita sua exclusão: 


echo "$nome mes/Sano - Sdescricao (R\$$valor) "; 
echo "<a href=V'elimina.php?id=Sidl">Excluir</a><br>" 


Agora precisamos criar o programa elimina. php, que será responsável por excluir 
o registro cujo identificador foi fornecido como parâmetro. Como você verá no có- 
digo a seguir, esse programa é bastante simples, visto que apenas abre uma conexão 
com o banco de dados e executa o comando DELETE da linguagem SQL para excluir 
o registro especificado: 


elimina.php 


<html> 
<body> 
<h? align="center">Exclusão de registros</h2> 
<?php 
include ‘valida cookies.inc'; 
$usuario = $.CO0KTET"usuario"]; 
$id = $_GET["id"]; 
// conecta ao banco de dados e exclui o registro 
include "conecta_banco.inc"; 
$res = dbx query($con, "detete from receitas. despesas where usuario='$usuario' 
and id='$id'"); 
dbx close($con); 
?> 
<p align="center">Exclusão realizada!</p> 
<p align="center"><a href="excluir.php">Exeluir outra</a> - 
<a href="principal.php">Vvoltar</a></p> 
</body> 
</html> 


Note que é importante testar se o registro que possui identificador fornecido 
pertence ao usuário que está acessando o sistema (where usuario='Susuario"), Se esse 
teste não fosse feito, um usuário conseguiria excluir registros de outros usuários. 


Apêndice À 


Comandos gerais do PHP 


Neste apêndice, veremos uma rápida descrição de cada um dos principais comandos 
do PHP Não serão mostrados todos os comandos da linguagem, mas principalmente 
aqueles que estão relacionados com os conteúdos apresentados neste livro. 


Os comandos foram divididos em diversas categorias: arrays, strings, variáveis, 


funções, classes e objetos, matemática, data e hora, sistema de arquivos (filesystem), 
diretórios, HTTP, FTP, URL, imagens, entre outras. 


Arrays 
Função 
array 
array change key case 
array chunk 


array. combine 


array count values 
array diff 


array diff. assoc 
array diff key 


array diff. uassoc 


array diff ukey 


array fil] 


Descrição 


Cria um array. 


Retorna um array com todas as chaves em letras maiúsculas 
ou minúsculas. 


Divide um array em diversos arrays com um determinado 
tamanho. 


Cria um array utilizando um array para as chaves e outro 
para seus valores. 


Conta todos os valores de um array. 
Calcula a diferença entre arrays. 


Calcula a diferença entre dois ou mais arrays, fazendo tam- 
bém a verificação dos índices. 

Retorna a diferença dos arrays fornecidos usando as chaves 
para comparação. 

Retorna a diferença entre arrays, fazendo uma verificação 
adicional de índices, que é executada poruma função callback 
fornecida pelo usuário. 


Retorna a diferença dos arrays fornecidos usando uma função 
callback nas chaves para comparação. 


Preenche um array com um determinado valor. 
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Função 


array fili.keys 
array. filter 
array flip 


array intersect 


array intersect assoc 


array intersect key 


array intersect uassoc 


array intersect ukey 


array key exists 
array keys 

array map 

array merge 


array merge recursive 


array multisort 
array. pad 
array. pop 
array product 
array push 
array. rand 
array reverse 
array. reduce 
array shift 
array slice 
array splice 
array sum 


array udiff 


array udiff assoc 


array udiff uassoc 


array uintersect 
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Descrição (cont.) 


Preenche um array com valores, especificando as chaves. 
Filtra elementos do array utilizando uma função de callback. 
Retorna um array com chaves e valores trocados. 

Calcula a intersecção entre arrays. 


Calcula a intersecção entre arrays, comparando também as 
chaves dos elementos. 


Calcula a intersecção entre arrays usando chaves para com- 
paração. 

Calcula a intersecção entre arrays com verificação adicional 
de índices, que são comparados por uma função callback. 


Calcula a intersecção entre arrays usando uma função call- 
back nas chaves para comparação. 


Verifica se uma determinada chave existe em um array. 
Retorna todas as chaves de um array. 

Aplica o callback sobre os elementos dos arrays dados. 
Une dois ou mais arrays. 

Une dois ou mais arrays recursivamente. 

Ordena arrays multidimensionais. 

Preenche determinado tamanho de um array 

Retira um elemento do fim do array. 

Calcula o produto dos valores em um array. 

Insere um elemento no fim do array. 

Retorna chaves para entradas randômicas de um array. 
Retorna um array com seus elementos em ordem reversa. 
Reduz um array a um valor simples. 

Retira um elemento do início do array. 

Retorna uma parte do array. 

Substitui uma parte de um array. 

Soma os elementos de um array. 


Retorna a diferença entre arrays, usando uma função callback 
para comparação de dados. 


Retornaa diferença entrearrays, com uma verificação adicional 
de índices, usando uma função callback para comparação 


de dados. 


Retornaa diferença entrearrays, com uma verificação adicional 
de índices, usando uma função caliback para comparação 
de dados. A checagem de índices também é feita por uma 
função callback. 


Calcula a intersecção de arrays. Os dados são comparados 
por uma função callback. 
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Função 


Descrição (cont.) 


array uintersect assoc 


array uintersect uassoc 


array unique 
array unshift 
array values 
array malk 


array walk recursive 


arsort 
asort 
compact 
count 
current 
each 

end 
extract 
in_array 


array_search 


key 
krsort 
ksort 
list 
natsort 


natcasesort 


next 
pos 
prev 
range 
reset 
rsort 
shuffle 


sizeof 


sort 


Calcula a intersecção de arrays com uma verificação adicio- 
nal de índices. Os dados são comparados por uma função 
callback. 


Calcula a intersecção de arrays com uma verificação adicional 
de índices. Os dados e os índices são comparados por uma 
função callback. 


Remove valores duplicados de um array. 

Coloca um ou mais elementos no início do array. 
Retorna todos os valores de um array. 

Aplica determinada função sobre cada membro do array. 


Aplicarecursivamente uma função do usuário a cada membro 
do array. 


Ordena um array em ordem reversa. 

Ordena um array. 

Cria um array contendo variáveis e seus valores. 

Conta o número de elementos em uma variável ou array. 

Retorna o elemento corrente de um array. 

Retorna o próximo par chave/valor de um array. 

Aponta o ponteiro interno do array para seu último elemento. 
Importa variáveis de um array para a tabela de símbolos. 

Retorna TRUE se determinado valor existe no array. 


Procura um valor dado em um array e retorna sua chave em 
caso de sucesso. 


Busca uma chave de um array associativo. 

Ordena um array por chave em ordem reversa. 
Ordena um array por chave. 

Atribui valores de um array a variáveis especificadas. 
Ordena um array usando o algoritmo “natural order” 


Ordena um array usando o algoritmo “natural order” não 
diferenciando letras maiúsculas de minúsculas. 


Avança o ponteiro interno de um array. 

Obtém o elemento corrente de um array. 

Retrocede o ponteiro interno de um array. 

Cria um array contendo determinada faixa de inteiros. 
Coloca o ponteiro interno do array em seu primeiro elemento. 
Ordena um array em ordem reversa. 


Embaralha um array trocando a ordem de seus elementos 
de forma aleatória. 


Obtém o número de elementos de um array. 
Ordena um array 
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Função 
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Descrição (cont.) 


uasort 
uksort 


usort 


Classes e objetos 


Função 


call user method array 


call user method 

class exists 

get class 

get class methods 
get.class vars 

get declared classes 
get declared interfaces 
get.object vars 

get parent.class 
interface exists 


isa 
is. subclass of 


method exists 


property exists 


ClibPDE 


Função 


Ordena um array com uma função definida pelo usuário e 
mantém a indexação. 


Ordena um array pelas chaves com uma função definida 
pelo usuário. 


Ordena um array por valores com uma função definida pelo 
usuário. 


Descrição 


Chama um método do usuário com um array de parâ- 
metros. 


Chama um método do usuário em um objeto específico. 
Testa se a classe foi definida. 

Retorna o nome da classe de um objeto. 

Retorna um array com o nome dos métodos da classe. 
Retorna um array com as propriedades-padrão da classe. 
Retorna um array com o nome das classes definidas. 
Retorna um array com todas as interfaces declaradas. 
Retorna um array associativo das propriedades do objeto. 
Retorna o nome da classe-pai (parent) de um objeto. 
Verifica se a interface foi definida. 


Verifica se um objeto é de uma classe ou tem essa classe 
como um de seus pais. 


Determina se um objeto pertence a uma subclasse da 
classe especificada. 


Testa se o método existe na classe, 


Checa se o objeto ou a classe possui uma determinada 
propriedade. 


Descrição 


cpdf add annotation 
cpdf add outline 
cpdf arc 

cpdf. begin text 
cpdf. circle 


Adiciona anotações ao documento. 
Adiciona um bookmark à página corrente. 
Desenha um arco. 

Inicia uma seção de texto. 


Desenha um círculo. 
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Função Descrição (cont.) 

cpdf clip Seleciona o caminho atual, definindo-o como clip 
path. 

cpdf close Fecha um documento PDF 


cpdf closepath Al stroke Completa o caminho corrente (adicionando uma linha 
do último ao primeiro ponto), preenchendo-o e dese- 
nhando-o no documento. 


cpdf. closepath stroke Completa o caminho corrente (adicionando uma linha do 
último ao primeiro ponto) e o desenha no documento. 

codf closepath Completa o caminho corrente adicionando uma linha 
do último ao primeiro ponto. 

cpdf continue text Escreve um texto na linha seguinte do documento. 

cpdf. curveto Desenha uma curva. 

cpdf end text Encerra uma seção de texto, 

cpdf fill. stroke Preenche o caminho atual e o desenha no documento. 

cpdf fill Preenche o caminho atual. 

cpdf finalize page Encerra uma página. 

cpdf.finalize Encerra o documento. 


cpdf global set document limits 
Define os limites para qualquer documento PDE 


cpdf import jpeg Abre uma imagem JPEG. 

cpdf lineto Desenha uma linha, 

cpdf. moveto Define o ponto corrente. 

cpdf newpath Inicia um novo caminho. 

cpdf. open Abre um novo documento PDF. 

cpdf. output buffer Envia para a saída o documento PDF armazenado em 
buffer. 

cpdf page init Inicia uma nova página. 

cpdf. place intine image Insere uma imagem na página. 

cpdf rect Desenha um retângulo. 

cpdf restore Restaura um ambiente salvo com a função cpdf save. 

cpdf rlineto Desenha uma linha. 

cpdf. rmoveto Define o ponto corrente. 

cpdf rotate text Define o ângulo de rotação para um texto, 

cpdf rotate Define o ângulo de rotação. 

cpdf save to.file Grava o documento PDF em um arquivo. 

cpdf save Salva o ambiente atual. 

cpdf scale Define o fator de escala para as duas direções (x e y). 

cpdf set action url Define um hyperlink. 


cpdf.set..char spacing Define o espaçamento entre os caracteres. 
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Função 
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Descrição (cont. 


cpdf set creator 


cpdf. set current page 
cpdf set font directories 


cpdf set font map file 


cpdf set font 


cpdf set horiz scaling 
cpdf set keywords 


cpdf. set leading 
cpdf. set page animation 
cpdf set subject 


cpdf set text matrix 


cpdf set text pos 


cpdf. set text rendering 
cpdf set text rise 
cpdf set title 


Define o campo do criador (“creator”) emum documento 
PDF. 


Define a página corrente. 


Define os diretórios a ser consultados quando forem 
utilizadas fontes externas. 


Define o nome da fonte a partir do arquivo que contém 
o mapa de tradução, quando forem utilizadas fontes 
externas. 


Seleciona a fonte corrente, assim como seu tamanho. 
Define a escala horizontal do texto. 


Define o campo de palavras-chave (“key words”) em um 
documento PDE 


Define a distância entre linhas de texto. 
Define o modo de transição entre as páginas. 


Define o campo de palavras-chave (“subject”) em um 
documento PDF. 


Define uma matriz que descreve as transformações a ser 
aplicadas na fonte corrente. 


Define a posição corrente para a escrita de textos no 
documento. 


Determina como o texto é desenhado (render). 
Define a elevação do texto. 


Define o campo de título (“title”) em um documento 
PDF. 


cpdf.set viewer preferences Permite configurar o modo de exibição do documento 


cpdf set word spacing 
cpdf setdash 
cpdf setflat 


cpdf setgray fill 
cpdf setgray stroke 
cpdf setgray 

cpf. setlinecap 


cpdf. setlinejoin 
cpdf setlinewidth 


cpdf setmiterlimit 
cpof. setrgbcolor. fill 


no visualizador, 
Define o espaçamento entre as palavras. 
Define o padrão de pontilhado. 


Define a distância máxima (flatness) entre o caminho de 
um objeto e uma aproximação criada com linhas. 


Define o cinza como cor de preenchimento. 
Define o cinza como cor para desenho. 
Define o cinza como cor de preenchimento e de desenho. 


Altera o valor do parâmetro linecap, que faz que a linha 
seja desenhada de forma diferente 


Configura o tipo de junção entre duas linhas. 


Define a espessura da linha que será utilizada para de- 
senhar as figuras. 


Configura o limite miter para um valor maior ou igual a 1. 


Define a cor de preenchimento de acordo com um valor 
RGB fornecido. 
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Descrição (cont.) 


cpdf setrgbcolor. stroke 


cpdf. setrgbcolor 


cpof. show xy 
cpdf show 

cpdf stringwidth 
cpdf stroke 
cpdf. text 


cpdf.translate 


Data e hora 


Função 


Define a cor de desenho de acordo com um valor RGB 
fornecido. 


Define a cor de preenchimento e de desenho de acordo 
com um valor RGB fornecido. 


Escreve um texto na posição especificada. 

Escreve um texto na posição corrente. 

Retorna a largura de um texto utilizando a fonte corrente. 
Desenha uma linha em torno do caminho corrente. 


Escreve um texto de acordo com os parâmetros especifi- 
cados. 


Define a origem do sistema de coordenadas. 


Descrição 


checkdate 
date 
date create 


date date set 


date default timezone. get 


date default. timezone set 


date format 
date isodate set 
date modify 


date offset get 


date parse 


date sun info 


date. sunset 

date sunrise 
date time set 
date timezone get 


date titmezone set 


Valida uma data/hora. 

Formata uma data/hora. 

Retorna um novo objeto do tipo Date Time, 
Define a data. 


Obtém o fuso horário padrão usado por todas as funções 
data/hora em um script. 


Define o fuso horário padrão usado por todas as funções 
data/hora em um script. 


Aplica um determinado formato à data fornecida. 
Define a data ISO. 


Altera um timestamp de acordo com o parâmetro de 
modificação informado. 


Retornaa posição em relação ao horário de verão (daylight 
saving time), 


Retorna umarray associativo com informações detalhadas 
sobre a data fornecida. 


Retorna um array com informações sobre o nascer e O 
pôr do sol. 


Hora do pôr do sol em um determinado dia e local. 
Hora do amanhecer em um determinado dia e local, 
Define a hora. 


Retorna o fuso horário relacionado com a data/hora 
fornecida. 


Define o fuso horário para o objeto DateTime fornecido. 
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dbx 


Função 
getdate 
gettimeofday 
gmdate 
gmmktime 


gmstrftime 


idate 
localtime 
microtime 
mktime 
strftime 


strptime 
strtotime 


time 
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Descrição (cont.) 


Retorna informações sobre data/hora. 

Retorna a hora atual. 

Formata uma data/hora GMT/CUT. 

Obtém uma data/hora GMT no formato Unix timestamp. 


Formata uma data/hora GMT/CUT conforme as conf- 
gurações locais. 


Formata uma data/hora local como um inteiro. 

Obtém a hora local. 

Retorna o Unix timestamp corrente em microssegundos. 
Obtém o Unix timestamp a partir de uma data. 


Formata uma data/hora local conforme as configurações 
locais. 


Analisa uma data/hora gerada pela função strftine(). 
Tenta traduzir uma string para o formato Unix timestamp. 


Retorna a data atual no formato Unix timestamp. 


timezone abbreviations list Retorna um array associativo contendo informações sobre 


o fuso horário, horário de verão e posição em relação ao 
GMT. 


timezone_identifiers_list Retorna um array indexado numericamente, contendo 


todos os identificadores de fuso horário. 


timezone name fromabbr Retorna o nome do fuso horário a partir de uma abre- 


timezone name get 


timezone offset get 


timezone open 


viação. 
Retorna o nome de um fuso horário. 


Retorna a posição de um fuso horário em relação ao 
GMT 


Retorna um novo objeto DateTimezone, 


timezone transitions get Retorna um array contendo todas as transições para um 


fuso horário. 


Função Descrição 

dbx.close Fecha uma conexão (aberta com o comando dbx connect) com 
um banco de dados. 

dbx compare Compara duas linhas para fins de ordenação. 


dbx. connect 


dbx error 


dbx escape string 


Abre uma conexão com um banco de dados. 


Retorna a mensagem de erro referente à última função executada 
pelo módulo do banco de dados. 


Adiciona caracteres de escape a um texto, para que este possa 
ser usado em um comando SQL sem gerar erros na sintaxe, 
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dbx fetch row 


Lê as linhas do resultado de uma requisição que tem a flag 


DBX RESULT. UNBUFFERED ativada. 


dbx query Envia um comando SQL ao banco de dados e obtém os resul- 
tados. 
dbx sort Ordena os registros resultantes de uma consulta utilizando uma 
função de ordenação personalizada. 
Diretórios 
Função Descrição 
chroot Altera o diretório do root. 
chdir Altera o diretório corrente. 
dir Classe diretório. 
closedir Fecha o handle do diretório. 
getcud Obtém o diretório corrente de trabalho. 
opendir Abre um handle de diretório. 
readdir Lê uma entrada a partir do handle do diretório. 
rewinddir Retrocede o handle do diretório. 
FTP 
Função Descrição 
ftp.aMoc Aloca espaço para um arquivo a ser enviado para O servidor, 
ftp.cdup Altera para o diretório que está um nível acima (parent). 
ftp chdir Altera o diretório em um servidor FTP, 
ftp. chmod Define as permissões de um arquivo via FTP. 
ftp close Fecha uma conexão FTP 
ftp. connect Abre uma conexão FTP, 
ftp delete Exclui arquivos em um servidor FTP. 
ftp exec Solicita a executação de um programa no servidor FTP. 
ftp. fget Faz o download de um arquivo do servidor FTP e salva em um 
arquivo aberto, 
ftp fput Envia de um arquivo aberto para um servidor FTP. 


ftp get option 


ftp get 
ftp login 
ftp mdtm 


Retorna diversas configurações em tempo de execução da conexão 


FTP corrente. 
Faz o download de um arquivo do servidor FTP. 
Realiza o login em uma conexão FTP. 


Retorna a hora da última modificação de determinado arquivo. 
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Função 

ftp mkdir 
ftp nb continue 
ftp nb fget 


ftp nb fput 


ftp.nb get 


ftp nb put 
ftp nlist 

ftp pasv 

ftp put 
ftpopwd 

ftp quit 
ftp.raw 

ftp rawlist 
ftp rename 

ftp rmdir 

ftp set option 
ftpsite 
ftp size 
ftp.ssi comect 
ftp systype 


Funções 


Função 


calt user funç array 


call user func 


create function 
func get arg 
func get args 


func.num args 


function exists 


PHP para quem conhece PHP 


Descrição (cont,) 


Cria um diretório. 
Continua enviando ou recebendo um arquivo (não-bloqueante). 


Retorna um arquivo de um servidor FTP e o grava em um arquivo 
aberto (não-bloqueante). 


Armazena um arquivo aberto em um servidor FTP (não-bloque- 
ante). 


Retorna um arquivo de um servidor FTP e o grava em um arquivo 
local €não-bloqueante). 


Armazena um arquivo no servidor FTP (não -bloqueante). 
Retorna uma lista dos arquivos em determinado diretório. 
Ativa ou desativa o modo passivo. 

Envia (upload) um arquivo para um servidor FTP. 
Retorna o nome do diretório corrente. 

Fecha uma conexão FTP 

Envia um comando arbitrário para um servidor FTP 
Retorna uma lista detalhada dos arquivos em determinado diretório. 
Renomeia arquivos em um servidor FTP. 

Remove um diretório. 

Define diversas opções do FTP em tempo de execução. 
Envia um comando do tipo SITE ao servidor. 

Retorna o tamanho de determinado arquivo. 

Abre uma conexão segura SSL-FTP 


Retorna o identificador do tipo de sistema do servidor remoto de 
FTP, 


Descrição 


Chama uma função do usuário passando um array de 
parâmetros. 


Chama uma função do usuário passando o primeiro 
parâmetro, 


Cria uma função anônima (estilo lambda). 

Retorna um item da lista de argumentos. 

Retorna um array contendo a lista de argumentos da 
função. 

Retorna o número de argumentos passados para uma 
função. 

Testa se uma função foi definida. 
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Função 


Descrição (cont.) 


get. defined functions 


Retorna um array contendo a lista de todas as funções 
definidas. 


register shutdown function Registra uma função para ser executada ao término do 


script. 
HTTP 
Função Descrição 
header Envia um cabeçalho HTTP 
headers. sent Testa se os headers já foram enviados. 
setcookie Envia um cookie. 
Imagens 
Função Descrição 


gd info 


image type to mime type 


imageZwbmp 
GetImageSize 


ImageAlphaBlending 
Inageantialias 

ImageArc 

InageFiledare 
ImageElVipse 
ImageFilledEl lipse 
ImageChar 

InageCharUp 
ImageColorAllocate 
ImageColorANocateAlpha 


ImageColorDeATlocate 
ImagelolorAt 
ImageColorClosest 


Retorna informações sobre a biblioteca GD atualmente 
instalada. 


Obtém o tipo MIME de um tipo de imagem retornado 
pelas funções geti magesize, exif. read data, exif thumbnail, 
exif_imagetype. 

Envia uma imagem do tipo WBMP para o navegador ou um 
arquivo. 

Retorna o tamanho de uma imagem GIF, JPEG, PNG ou 
SWE 


Define o modo de transparência de uma imagem. 
Indica se as funções de antialias devem ser usadas. 
Desenha uma elipse parcial. 

Desenha uma elipse parcial preenchida. 

Desenha uma elipse. 

Desenha uma elipse preenchida. 

Desenha um caractere horizontalmente. 

Desenha um caractere verticalmente. 

Aloca uma cor para uma imagem. 


Aloca uma cor para uma imagem. É semelhante à função 
ImageColtorA] locate, possuindo um parâmetro adicional para 
definir a transparência. 


Desaloca uma cor para uma imagem. 
Retorna o índice da cor de um pixel, 


Retorna o índice da cor mais próxima à especificada. 
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Função 
ImageColorClosestAlpha 


IrageColorClosestHWB 


ImageColorÊxact 
ImageColorExactATpha 
ImageColorResolve 


ImageColorResolveAlpha 


ImageGammaCorrect 
ImageColorset 
ImageColorsForIndex 
ImageColorsTotal 
ImageColorTransparent 
ImageCopy 
ImageCopyMerge 
ImageCopyMergeGray 
ImageCopyResized 
ImageCopyResampled 


ImageCreate 
ImageCreateTrueColor 
ImageTrueColorToPalette 
ImageCreateFromGD2 


ImageCreateFromGD2part 


ImageCreateFromGD 


ImageCreateFromGIF 


ImageCreateFrom]JPEG 


ImageCreateFromPNG 


InageCreateFromwBMP 


ImageCreateFromString 


PHP para quem conhece PHP 


Descrição (cont.) 


Obtém o índice da cor mais próxima à cor especificada, 
considerando o parâmetro de transparência. 


Obtém o índice da cor que possui o tom, branco e preto mais 
próximo da cor especificada. 


Retorna o índice de uma cor especificada. 
Retorna o índice de uma cor especificada + alpha. 


Retorna o índice de uma cor ou sua alternativa mais próxi- 
ma. 


Retorna o índice de uma cor + alpha ou sua alternativa mais 
próxima, 

Aplica uma correção gamma em uma imagem GD, 

Define a cor para o índice da paleta especificada. 

Obtém as cores para um índice. 

Retorna o número de cores de uma paleta de imagens. 
Define uma cor como transparente. 

Copia parte de uma imagem. 

Copia e une parte de uma imagem. 

Copia e une parte de uma imagem com tons de cinza. 
Copia e redimensiona parte de uma imagem. 

Copia e redimensiona parte de uma imagem com 
resampling. 

Cria uma nova imagem, 

Cria uma nova imagem true color, 

Converte uma imagem de true color para palette. 


Cria uma nova imagem a partir de um arquivo GD2 ou de 
um URL. 


Cria uma nova imagem baseada em uma parte de umarquivo 
GD2 ou de um URL. 


Cria uma nova imagem a partir de um arquivo GD ou de 
um URL. 
Cria uma nova imagem a partir de um arquivo GIF ou de 
um URL. 


Cria uma nova imagem a partir de um arquivo JPEG ou de 
um URL. 


Cria uma nova imagem a partir de um arquivo PNG ou de 
um URL. 


Cria uma nova imagem a partir de um arquivo WBMP ou 
de um URL. 


Retorna um identificador representando a imagem obtida 
de determinada string. 
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Função Descrição (cont.) 

ImageCreateFromkBM Cria uma nova imagem a partir de um arquivo XBM ou de 
um URL. 

ImageCreateFromkPM Cria uma nova imagem a partir de um arquivo XPM ou de 
um URL. 

TmageDashedLine Desenha uma linha pontilhada. 

ImageDestroy Destrói uma imagem. 

ImageEl lipse Desenha uma elipse. 

ImageFi ll Preenche uma imagem ou parte dela. 

ImageFitledArc Desenha um elipse parcial preenchida com uma determinada 
cor, 

ImageFilledETipse Desenha um elipse preenchida com uma determinada cor. 

ImageFilTledPolygon Desenha um poligono preenchido. 

ImageFi VedRectangle Desenha um retângulo preenchido. 

ImageFill ToBorder Preenche uma imagem com determinada cor. 

ImageFontHeight Obtém a altura da fonte. 

ImageFontWidth Obtém a largura da fonte. 

ImageFtbBox Usa fontes Free Type 2 para definir uma caixa (bounding 
box) para o texto. 

ImageFtText Escreve um texto em uma imagem usando fontes Free- 
Type 2. 

Image6D2 Envia uma imagem GD?2 para o browser ou para um arquivo. 

ImageGD Envia uma imagem GD para o browser ou para um arquivo. 

ImageGIF Envia uma imagem GIF para o browser ou para um arquivo. 

ImagePNG Envia uma imagem PNG para o browser ou para um arquivo. 

Image JPEG Envia uma imagem JPEG para o browser ou para um arquivo. 

Imagelayereffect Define a flag de transparência alpha para o uso de efeitos 
nas camadas (layers). 

IntagewBMP Envia uma imagem WBMP para o browser ou para um 
arquivo. 

ImageInterlace Habilita ou desabilita o entrelaçamento. 

ImageisTrueColor Verifica se uma imagem é true color (24 bits). 

ImageLine Desenha uma linha. 

ImageLoadFont Carrega uma nova fonte. 

ImagePaletteCopy Copia a paleta de cores de uma imagem para outra. 

ImagePolygon Desenha um polígono. 

ImagePSBBox Usa uma fonte Postscript e define uma caixa para o texto. 

ImagePSCopyFont Faz a cópia de uma fonte já carregada, para posterior modi- 
ficação. 

ImagePSEncodeFont Altera o vetor de codificação de caracteres para uma fonte. 


TmagePSExtendFont 


Estende ou condensa uma fonte. 
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Função 


PHP para quem conhece PHP 


Descrição (cont.) 


ImagePSFreaFont 
ImageP5LoadFont 
ImagePsExtendFont 
ImagePsSlantFont 
ImagePSText 
ImageRectangle 
ImageRotate 


ImageSaveAlpha 


ImageSetPixe]l 
ImageSetBrush 
ImageSetStyle 
ImageSetTile 


ImageSetThickness 
InageString 
ImageStringUp 
ImagesX 

ImageSY 
ImageTTFBBox 
ImageTTFText 
ImageTypes 


iptcembed 
iptcparse 
jpeg2wbmp 
png2wbmp 


IMAP, POP3 e NNTP 


Função 


Libera a memória usada por uma fonte PostScript do tipo 1. 
Carrega a fonte PostScript tipo 1 de um arquivo. 

Estende ou condensa uma fonte. 

Inclina uma fonte. 

Desenha um texto sobre uma imagem. 

Desenha um retângulo. 


Realiza uma rotação em uma imagem, considerando o ângulo 
especificado. 


Usada em imagens PNG para configurar a flag que indica 
se as informações sobre o canal alfa (alpha channel) devem 
ser salvas. 


Define um pixel simples. 
Define uma imagem para desenho de linhas. 
Define o estilo para o desenho de linhas. 


Define uma imagem (tile) para o preenchimento de uma 
área. 


Define a espessura de uma linha. 

Desenha uma string horizontalmente. 

Desenha uma string verticalmente. 

Retorna a largura da imagem. 

Retorna a altura da imagem. 

Usa fontes Type Type e define uma caixa para o texto. 
Escreve o texto na imagem usando fontes True Type. 


Retorna o tipo das imagens suportadas pela compilação 
atual do PHE 


Embute dados binários IPTC em uma imagem JPEG. 
Analisa um bloco binário IPTC em tags simples. 
Converte uma imagem JPEG para o formato WBMP. 
Converte uma imagem PNG para o formato WBMP 


Descrição 


imap &bit 


imap alerts 


imap append 


Converte uma string de 8 bits em uma string delimitada 
por aspas, de acordo com o formato RFC2045. 

Retorna todas mensagens de alertas do IMAP que ocor- 
reram durante a requisição da página ou desde que a 
pilha de alertas tenha sido reiniciada. 


Concatena uma mensagem a uma caixa de correio. 


Função 
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Descrição (cont.) 


imap baseb4 
imap binary 


imap..body 
imap bodystruct 


imap check 

imap clearfag full 
imap close 

imap createmailbox 
imap delete 


imap deletemailbox 


imap errors 


imap expunge 


imap fetch. overview 


imap fetchbody 


imap fetchheader 
imap fetchstructure 
imap. get quota 


imap get. quotarcot 
imap getmailboxes 


imap getsubscribed 
imap header 

imap headerinfo 
imap headers 


imap last.error 


imap Vist 
imap. Jistmailbox 


imap listscan 


imap Vistsubscribed 


Decodifica um texto codificado no formato BASE64. 


Converte uma string de 8 bits em uma string de base 
64. 


Lê o corpo de uma mensagem, 


Lê a estrutura de uma determinada seção do corpo de 
uma mensagem. 


Checa a caixa de correio atual. 
Limpa as flags das mensagens. 
Fecha uma corrente (stream) IMAP. 
Cria uma nova caixa de correio. 


Marca a mensagem para exclusão na caixa de correio 
atual. 


Exclui uma caixa de correio. 


Retorna todas mensagens de erro do IMAP que ocorreram 
durante a requisição da página ou desde que a pilha de 
erros tenha sido reiniciada. 


Exclui todas as mensagens marcadas para exclusão. 


Lê informações resumidas a partir do cabeçalho da 
mensagem especificada. 


Busca por uma determinada seção no corpo de uma 
mensagem. 


Retorna o cabeçalho para uma mensagem. 
Lê a estrutura de uma determinada mensagem. 


Retorna as configurações de cotas e as estatísticas de uso 
de uma caixa de correio. 


Retorna as configurações de cotas por usuário. 


Lê a lista de caixas de correio, retornando informações 
detalhadas sobre cada uma. 


Lista todas as caixas de correio disponíveis a um usuário. 
Apelido para a função imap.headerinfo. 
Lê o cabeçalho da mensagem. 


Retorna o cabeçalho para todas as mensagens da caixa 
de correio. 


Retorna o último erro IMAP que ocorreu durante a 
solicitação da página. 

Lê a lista de caixas de correio. 

Apelido para a função imap Jist. 


Lê a lista de caixas de correio e busca por uma determi- 
nada string nos resultados. 


Apelido para a função imap 1sub. 


422 


Função 


PHP paro quem conhece PHP 


Descrição (cont.) 


inap sub 

imap mail. compose 
imap mail. copy 

imap mail move 

imap mail 

imap mailboxmsginto 


imap mime header. decode 


imap msgno 


imap num. msg 


ilmap num recent 


imap. open 


imap.ping 
imap gprint 


imap renamemai box 
imap reopen 


imap rfc822 parse adrlist 
itap rfcê22 parse headers 
imap rfc622 write address 


imap scanmailbox 


imap search 


imap set quota 
imap setac] 

imap setflag. full 
imap sort 

imap status 


imap subscribe 
imap thread 


Retorna a lista das caixas de correio nas quais o usuário 
está inscrito. 


Cria uma mensagem MIME baseada em um determinado 
envelope (from, to, cc...) e seções de corpo. 


Copia as mensagens especificadas para uma caixa de 
correio, 


Move as mensagens especificadas para uma caixa de 
correio. 


Envia uma mensagem de e-mail. 
Obtém informações sobre a caixa de correio atual. 
Decodifica elementos de cabeçalhos MIME. 


Retorna o número de segiiência da mensagem para o 
identificador (UID) especificado. 


Obtém o número de mensagens existentes em uma caixa 
de correio. 


Obtém o número de mensagens recentes em uma caixa 
de correio. 


Abre uma corrente (stream) IMAP para uma caixa de 
correio. 


Verifica se o stream IMAP está ativo. 


Converte uma string delimitada por aspas para uma 
string de 8 bits. 


Renomeia uma caixa de correio. 


Abre novamente um stream IMAP para uma caixa de 
correio. 


Analisa uma string com endereços. 
Analisa uma string com cabeçalhos de e-mail. 


Retorna um endereço de e-mail formatado, de acordo com 
a caixa de correio, servidor e informações pessoais. 


Apelido para a função imap Vistscan. 


Retorna um array de mensagens de acordo com um 
determinado critério de busca. 


Define a cota para a caixa de correio especificada. 
Define a ACL para a caixa de correio especificada. 
Define as flags nas mensagens, 

Ordena um array de cabeçalhos de mensagens. 


Retorna informações sobre o estado de uma determinada 
caixa de correio. 


Realiza a inscrição em uma caixa de correio. 


Retorna umartay com informaçõesorganizadas (threaded) 
sobre as mensagens. 


Função 
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Descrição (cont.) 


imap uid 


imnap undelete 

jmap unsubscribe 
imap utf7. decode 
imap utf7 encode 


imap utfê 


InterBase 


Função 


Retorna oidentificador (UTD) para o número de sequência 
de mensagem fornecido. 


Desmarca uma mensagem que foi marcada para exclusão. 
Cancela a inscrição em uma caixa de correio. 
Decodifica uma string codificada no formato UTF-Z 


Converte uma string do formato ISO-8859-1 para o for- 
mato UTF-7. 


Converte um texto MIME codificado para o formato 
UTE-8 


Descrição 


ibase add user 


ibase affected rows 


ibase backup 
ibase blob add 
ibase blob cancel 
ibase blob close 
ibase blob create 
ibase blob echo 
ibase blob get 
ibase blob import 


ibase blob info 


ibase blob open 
ibase close 


ibase commit 


ibase commit ret 
ibase connect 
ibase db info 
ibase drop db 
ibase errcode 
ibase errmsg 


ibase execute 


Adiciona um usuário ao banco de dados de segurança (so- 
mente para IB6 ou posterior). 


Número de linhas afetadas pela operação anterior. 
Inicia uma tarefa de backup no gerenciador de serviços. 
Adiciona dados em um objeto do tipo BLOB. 

Cancela a criação de um objeto do tipo BLOB. 

Fecha um objeto do tipo BLOB. 

Cria um objeto do tipo BLOB para adicionar dados. 
Exibe no navegador o conteúdo de um objeto BLOB. 
Retorna o tamanho, em bytes, de um objeto BLOB aberto. 


Cria um objeto BLOB, copia um arquivo dentro dele e o 
fecha. 


Retorna o tamanho de um objeto BLOB e outras informações 
úteis. 

Abre um objeto BLOB para retornar partes de dados. 
Fecha a conexão com um banco de dados InterBase. 


Confirma uma transação, tornando suas alterações perma- 
nentes no banco de dados. 


Confirma uma transação sem fechá-la. 

Abre uma conexão com um banco de dados InterBase. 
Obtém estatísticas sobre um banco de dados. 

Exclui um banco de dados. 

Retorna um código de erro. 

Retorna mensagens de erro. 


Executa uma consulta previamente preparada. 
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Função 

ibase fetch object 
ibase fetch row 
ibase field info 


PHP para quem conhece PHP 


Descrição (cont.) 

Obtém um objeto de um banco de dados InterBase. 
Busca uma linha de um banco de dados InterBase. 
Obtém informações sobre um determinado campo. 


ibase free event handler Cancela um handler de eventos registrado. 


tbase free query 
tbase free result 
ibase gen id 


ibase maintain db 


ibase name result 
ibase num fields 
ibase num paras 
ibase param info 


ibase pconnect 


ibase. prepare 


ibase query 

ibase restore 
ibase rollhack 
ibase roliback ret 
ibase server info 


ibase service attach 


ibase. service detach 
ibase set event. handler 


ibase timefimt 


ibase trans 
ibase wait event 


Libera a memória alocada para uma consulta preparada. 
Libera o conjunto de linhas de um resultado (result set). 
Incrementa o gerador especificado e retorna seu novo valor. 
Executa um comando de manutenção no servidor de banco 


de dados. 

Atribui um nome a um conjunto de resultados (result set). 
Obtém o número de campos existentes em um result set. 
Retorna o número de parâmetros de uma consulta preparada. 


Retorna informações sobre um parâmetro de uma consulta 
preparada. 


Cria uma conexão persistente com um banco de dados 
InterBase, 


Prepara uma consulta para posterior ligação (binding) de 
parâmetros e execução. 


Executa uma consulta em um banco de dados InterBase. 
Inicia uma tarefa de restauração no gerenciador de serviços. 
Destaz as alterações feitas por uma transação e a encerra. 
Desfaz uma transação e mantém seu contexto. 

Obtém estatísticas sobre um banco de dados. 


Abre uma conexão com o gerenciador de serviços (service 
manager). 


Desconecta do gerenciador de serviços. 


Registra uma função callback, que será chamada na ocor- 
tência de eventos, 


Define o formato das colunas dos tipos timestamp, date e 
time retornadas pelas consultas. 


Inicia uma transação, 


Aguarda por um evento a ser postado pelo banco de dados. 


Matemática 
Função Descrição 
abs Valor absoluto. 
aços Árco co-seno. 


acosh Arco co-seno hiperbólico. 
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Função Descrição (cont.) 

asin Arco seno. 

asinh Arco seno hiperbólico. 

atan Arco tangente, 

atan? Arco tangente de duas variáveis. 
atanh Arco tangente hiperbólico. 


base. convert 
bindec 
ceil 
cos 
cosh 
decbin 
dechex 
decoct 
deg?rad 
exp 
expml 


floor 
getrandmax 
hexdec 


hypot 


is finite 


is. infinite 


is.nan 
leg value 
Tog 

Togl0 
Toglp 


max 

min 

mt. rand 

mt srand 

mt getrandmax 
number format 
octdet 


Converte um número entre duas bases arbitrárias. 
Converte de binário para decimal. 

Arredonda frações para cima. 

Co-seno. 

Co-seno hiperbólico. 

Converte de decimal para binário. 

Converte de decimal para hexadecimal. 

Converte de decimal para octal. 

Converte um número de graus para radianos. 
Eleva “e” a determinada potência. 


Retorna exp(número)-1, calculado de forma precisa mesmo quando 
o número for próximo de zero. 


Arredonda frações para baixo. 
Mostra o maior valor randômico possível. 
Converte de hexadecimal para decimal. 


Aplica a fórmula da hipotenusa aos valores fornecidos, ou seja, 
sgrtCnuml?numl + num2* num). 


Verifica se um valor em ponto flutuante é finito dentro dos limites 
da plataforma. 


Verifica se um valor em ponto flutuante é infinito dentro dos limites 
da plataforma. Exemplo: Tog(0). 


Retorna true se o valor fornecido não for um número (Not a Number). 
Retorna um número pseudo-aleatório entre 0 e 1. 

Logaritmo natural. 

Logaritmo de base 10. 


Retorna log(1 + número), calculado de forma precisa mesmo quando 
o número for próximo de zero. 


Retorna o maior valor. 

Retorna o menor valor. 

Gera um valor randômico melhor. 

Define o melhor gerador de números randômicos. 
Mostra o maior valor randômico possível. 
Formata um número. 


Converte de octal para decimal. 
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Função Descrição (cont.) 

pi Retorna o valor do número pi. 

pow Eleva um número a outro. 

rad2deg Converte um número de radianos para graus. 
rand Gera um valor aleatório. 

round Arredonda um número em ponto flutuante. 
sin Seno. 

sinh Seno hiperbólico. 

sgrt Raiz quadrada. 

srand Define um gerador de números aleatórios. 
tan Tangente 

tanh Tangente hiperbólica. 


Microsoft SQL Server 


Função 


Descrição 


mssgl bind 


mssql close 
mssql_connect 
mssql data seek 
m55ql execute 


mssql fetch array 
mssql fetch assoc 


mssql..fetch batch 


mssql fetch field 


Adiciona um parâmetro a um procedimento armazenado 
local ou remoto. 


Fecha uma conexão estabelecida com o MS SQL Server. 
Abre uma conexão com um servidor MS SQL server. 
Move o ponteiro interno das linhas. 


Executa um procedimento armazenado em um servidor MS 
SQL server. 


Obtém uma linha do resultado como um array. 


Retorna um array associativo contendo a linha corrente do 
conjunto de resultados (result set) especificado. 


Retorna o próximo conjunto de registros armazenados em 
memória. 


Obtém informações sobre um campo. 


mssgl. fetch object Obtém uma linha do resultado como um objeto. 


mssgl Fetch row 


nssql.field Tength 
mssql field name 
mssql field seek 
mssgl held type 
mssgl. free result 


Obtém uma linha do resultado como um array com índices 
numéricos. 


Obtém o tamanho de um campo. 

Obtém o nome de um campo. 

Faz uma busca no campo pelo offset especificado. 
Obtém o tipo de um campo. 

Libera a memória alocada para armazenar um resultado. 


mssql free statement Libera a memória alocada para execução de um comando. 


mssql get last message Retorna a última mensagem gerada pelo servidor. 


essql. guid string 


Converte um GUID binário de 16 bytes para string. 
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Função 


Descrição (cont.) 


mssql init 


Inicializa um procedimento armazenado local ou remoto. 


nssql min error severity Define a menor severidade para um erro. 


mssql min message severity Define a menor severidade para uma mensagem. 


mssql next result 
mssgl. num fields 
mssql num rows 
m55q1. pconnect 
mssgl query 

mssql result 
mssql rows affected 
nssql select db 


mSQL 


Função 


Move o ponteiro interno do resultado para a linha seguinte, 
Obtém o número de campos do resultado. 

Obtém o número de linhas do resultado. 

Abre uma conexão persistente com o servidor MS SQL. 
Envia uma consulta ao servidor MS SQL. 

Obtém os dados de um resultado. 

Retorna o número de registros afetados por uma operação. 
Seleciona um banco de dados MS SQL. 


Descrição 


msgl affected rows 
msql close 

msql. connect 

msql create db 
msgl createdb 
msgl. data seek 
msql dbname 

msg! drop db 
msql. dropdb 
msgl.error 

msg] fetch array 
msql. fetch field 
msg. fetch object 
msql fetch row 


msql field seek 
msql_fieldflags 
msql fieldlen 
msql_fieldname 
msql fieldtable 
msql fieldtype 
msgl free result 
msg]. freeresult 


Retorna o número de registros afetados por uma operação. 
Fecha uma conexão mSQL. 

Abre uma conexão mSQL. 

Cria um banco de dados mSQL. 

Cria um banco de dados mSQL. 

Move o ponteiro interno das linhas, 

Obtém o nome do banco de dados mSQL corrente. 
Exclui um banco de dados mSQL. 

Exclui um banco de dados mSQL. 

Retorna a mensagem de erro da última chamada mSQL. 
Obtém uma linha do resultado como um array. 

Obtém informações sobre um campo. 

Obtém uma linha do resultado como um objeto. 


Obtém uma linha do resultado como um array com índices 
numéricos. 


Define o offset de um campo. 

Obtém as flags de um campo, 

Obtém o tamanho de um campo. 

Obtém o nome de um campo. 

Obtém o nome da tabela à qual pertence o campo. 
Obtém o tipo de um campo. 

Libera a memória alocada para armazenar um resultado. 


Libera a memória alocada para armazenar um resultado. 
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Função 


PHP para quem conhece PHP 


Descrição (cont.) 


msql ist dbs 
msql_list fields 
msql tist.tables 
msql. listdbs 
nsql listfields 
msql. Jisttables 
msg] num fields 
imsql num rows 
msg |. numfelds 
msql_numrows 
nsql.pconnect 
nsql query 
msql. regcase 


msg! result 
msgT select. db 
msg] selectdb 
msg]. tablename 
msg] 


MySQL 


Função 


mysql affected rows 
mysql. change user 
mysql client encoding 


mysql. close 
mysql. connect 
mysql create db 
mysql data seek 
mysql.db name 
mysql db query 


mysql drop db 
mysql errno 


mysql error 


Lista os bancos de dados mSQL existentes no servidor. 
Lista os campos resultantes. 

Lista as tabelas existentes em um banco de dados mSQL. 
Lista os bancos de dados mSQL existentes no servidor. 
Lista os campos resultantes. 

Lista as tabelas existentes em um banco de dados mSQL. 
Obtém o número de campos do resultado. 

Obtém o número de linhas do resultado. 

Obtém o número de campos do resultado. 

Obtém o número de linhas do resultado. 

Abre uma conexão persistente com o servidor mSQL. 
Envia uma consulta ao servidor mSQL. 


Retorna uma expressão regular para comparações case insensitive 


(não diferencia maiúsculas de minúsculas), 
Obtém os dados do resultado. 

Seleciona um banco de dados mSQL. 

Seleciona um banco de dados mSQL. 

Obtém o nome da tabela à qual pertence o campo. 
Envia uma consulta ao servidor mSQL. 


Descrição 


Obtém o número de linhas afetadas em uma operação. 


Altera o usuário na conexão ativa. 


cliente. 

Fecha uma conexão MySQL. 

Abre uma conexão com o servidor MySQL. 
Cria um banco de dados MySQL. 

Move o ponteiro interno de resultado. 
Obtém dados do resultado. 


Envia uma consulta MySQL a determinado banco de da- 


dos. 

Exclui um banco de dados MySQL. 

Retorna o número do erro de uma operação executada. 
Retorna a mensagem de erro de uma operação executada. 


Retorna o nome do conjunto de caracteres utilizado pelo 


Apêndice A » Comandos gerais do PHP 


Função 


479 


Descrição (cont.) 


mysql escape string 


mysql. fetch array 


nysgl fetch assoc 
mysql fetch.field 


mysql fetch Tengths 
mysql. fetch object 
mysql fetch.row 
mysql. field flags 

mysql field name 
mysql.field Ten 

mysql. field seek 
mysql.held table 
mysql field type 
mysql. free result 
nysql get client.info 
mysql. get. host info 
nysgl.get proto-info 
mysql. get server-info 
mysql.info 


mysql insert.id 


mysql Hist dbs 
mysql. Vist fields 
mysql list processes 


mysql list tables 
my]. num fields 
mysql. num rows 
mysql. pconnect 
mysql. ping 


mysql query 


Adiciona caracteres de escape a uma string, para que esta 
possa ser usada em um comando SQL sem gerar erros na 
sintaxe. 


Coloca uma linha do resultado em um array associativo, 
numérico ou ambos. 


Coloca uma linha do resultado em um array associativo. 


Retorna um objeto com informações sobre um campo da 
consulta. 


Retorna o tamanho de cada campo em uma consulta 
Busca o resultado como um objeto. 

Obtém uma linha do resultado como um array enumerado. 
Retorna os flags associados a um campo de uma consulta. 
Retorna o nome de determinado campo. 

Retorna o tamanho de determinado campo. 

Posiciona o ponteiro para um campo específico da consulta. 
Retorna o nome da tabela à qual o campo pertence. 
Retorna o tipo de determinado campo. 

Libera a memória reservada para uma consulta. 

Retorna informações sobre a versão do cliente MySQL. 
Retorna o tipo de conexão estabelecida com o servidor. 
Retorna informações do protocolo utilizado na conexão. 
Retorna a versão do servidor MySQL. 


Retorna informações detalhadas sobre a última consulta 
realizada. 


Obtém o ID gerado por uma operação INSERT executada 
anteriormente. 


Lista os bancos de dados existentes no servidor MySQL. 
Lista os campos do resultado. 


Lista os processos do MySQL. Retorna um ponteiro para os 
resultados, que descrevem as threads atuais. 


Lista tabelas em um banco de dados MySQL. 

Retorna o número de campos do resultado. 

Retorna o número de linhas do resultado. 

Abre uma conexão persistente com um servidor MySQL. 


Envia um ping para verificar sea conexão com O servidor está 
ativa. Se não estiver, tenta reconectar automaticamente. 


Envia uma consulta MySQL. 
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Função 


PHP para quem conhece PHP 


Descrição (cont) 


mysql real escape string Adiciona caracteres de escape a uma string, para que esta 
possa serusada em um comando SQL. Considera o conjunto 
de caracteres em uso na conexão. 


mysql. result 
mysql. select db 
mysql. stat 


Obtém os dados do resultado. 
Seleciona um banco de dados MySQL. 


Retorna uma string contendo informações sobre o estado 


corrente do sistema. 


mysql. tablename 
mysgl thread id 


Obtém o nome da tabela do campo. 
Retorna um valor inteiro que representa o identificador da 


thread atual. 


mysql unbuffered query 


Envia uma consulta SQLao servidor MySQL, sem armazenar 


em um buffer as linhas resultantes. 


MySQLi 


Função 


Descrição 


mysqli affected rows 
mysqli autocommit 


mysqli bind param 
nysgli bind result 


mysqli..change user 
mnysqli character set name 


mysqli close 

mysqli. commit 

mysqli. connect 
mysqli data seek 
mysqli debug 

mysqli dump debug info 


mysqlierrno 

mysqli error 

mysqli execute 
mysqli fetch array 


mysqli fetch assoc 
mysqli fetch.field direct 


Obtém o número de linhas afetadas em uma operação. 


Habilita ou desabilita a confirmação automática (auto- 
commit) das modificações. 


Associa uma variável a um parâmetro de um comando 
preparado. 


Associa uma variável a um comando preparado, para 
armazenamento do resultado. 


Altera o usuário na conexão ativa. 


Retorna o nome do conjunto de caracteres utilizado pelo 
cliente. 


Fecha uma conexão MySQL. 

Confirma a transação corrente. 

Abre uma conexão com o servidor MySQL. 

Move o ponteiro interno de resultado. 

Realiza operações de depuração. 

Grava informações de depuração no registro (log) do 
MySQL, 

Retorna o número do erro de uma operação executada. 
Retorna a mensagem de erro de uma operação executada. 
Executa uma consulta previamente preparada. 


Coloca uma linha do resultado em um array associativo, 
numérico ou ambos, 


Coloca uma linha do resultado em um artay associativo. 
Obtém os metadados para um determinado campo. 


Função 
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Descrição (cont.) 


mysqli fetch.field 


mysqli fetch.fields 


mysgli fetch Tengths 
mysqli fetch object 
mysgli fetch row 


mysgh fetch 


mysqli field count 
mysqli field seek 


mysqlifield tel 


mysgli.free result 


nysqli get clientinto 


mysqli get.host.info 
mysqli..get proto info 


mysqli get server info 
mysqli get. server version 


mysqli_info 


mysqli_imit 


mysqli_insert_id 


mysqli kill 


nysqli master query 


mysgli num fields 
mysgli num rows 
mysqli options 
mysqli. param count 


mysghi ping 


mysql. prepare 
mysql. query 


Retorna um objeto com informações sobre um campo 
da consulta. 


Retorna um array de objetos com informações sobre os 
campos da consulta. 


Retorna o tamanho de cada campo em uma consulta. 
Busca o resultado como um objeto. 


Obtém uma linha do resultado como um array enume- 
rado. 


Armazena nas variáveis associadas (bind) os resultados 
de um comando preparado. 


Retorna o número de colunas da consulta mais recente. 


Posiciona o ponteiro para um campo específico da con- 
sulta, 


Retorna o número do campo corrente em um ponteiro 
de resultado. 


Libera a memória reservada para uma consulta, 
Retorna informações sobre a versão do cliente MySQL. 
Retorna o tipo de conexão estabelecida com o servidor. 
Retorna informações do protocolo utilizado na conexão. 
Retorna a versão do servidor MySQL. 


Retorna a versão de um servidor MySQL como um in- 
teiro. 


Retorna informações detalhadas sobre a última consulta 
realizada. 


Inicializa a MySQLi e retorna um recurso para uso na 
função mysgli real -comect. 


Obtém o ID gerado por uma operação INSERT executada 
anteriormente. 


Solicita ao servidor o encerramento de um determinado 
processo (thread) MySQL. 


Em uma configuração master/slave (mestre/escravo), 
força a execução da consulta no master. 


Retorna o número de campos do resultado. 
Retorna o número de linhas do resultado. 
Configura opções do MySQL. 


Retorna o número de parâmetros de um determinado 
comando, 


Envia um ping paraverificar sea conexão como servidor está 
ativa. Se não estiver, tenta reconectar automaticamente, 


Prepara um comando SQL para execução. 
Envia uma consulta MySQL. 
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Função 


PHP para quem conhece PHP 


Descrição (cont.) 


mysqli real. connect 
mysql. real escape string 


mysqli. real query 
mysqli romback 
mysqli select db 


mysql slave query 


mysgli stat 


mysqli stmt close 


mysqli store result 


mysqli thread id 


nysqli thread safe 


mysgli use result 


mysqli warning count 


Abre uma conexão com um servidor MySQL. 


Adiciona caracteres de escape a uma string, para que 
esta possa ser usada em um comando SQL. Considera 
o conjunto de caracteres em uso na conexão. 


Executa uma consulta SQL. 
Cancela a transação corrente. 
Seleciona um banco de dados MySQL. 


Em uma configuração master/slave (mestre/escravo), 
força a execução da consulta no slave. 


Retorna uma string contendo informações sobre o estado 
corrente do sistema. 


Fecha um comando. 


Transfere o resultado da última consulta para ser usado 
pela função mysqli data seekO). 

Retorna um valor inteiro que representa o identificador 
da thread atual. 

Indica se a segurança de um processo (thread) está defi- 
nida ou não. 

Inicia o retorno de um resultado (result set) da última 
consulta executada por mysgli real query). 


Retorna o número de avisos (warnings) gerados pela 
última consulta executada. 


Função Descrição 

ocibindhyname Associa uma variável PHP a um placeholder do Oracle. 

ocicancel Cancela a leitura de dados a partir de um cursor. 

ocicloselab Fecha o descritor do objeto. 

ocicoliappend Adiciona um objeto à coleção. 

ocicoltassign Atribui uma coleção a partir de outra já existente. 

ocicollassignelem Atribui um valor do elemento à coleção, utilizando o índice 
especificado. 

ocicolIgetelem Retorna o valor da coleção em um determinado índice. 

ocicol Imax Retorna o valor máximo de uma coleção. 

ocicolTsize Retorna o tamanho de uma coleção. 

ocicoNtrim Remove um determinado número de elementos do final de 
uma coleção. 

ocicolumnisnull Testa se uma coluna do resultado é nula (NULL). 

ocicolumname Retorna o nome de uma coluna. 
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ocicolumnprecision Retorna a precisão de uma coluna, 

ocicolumnscale Retorna a escala de uma coluna. 

ocicolumsize Retorna o tamanho de uma coluna do resultado. 

ocicolumntype Retorna o tipo de dados de uma coluna. 

ocicolumntyperaw Retorna o tipo de uma determinada coluna como um número 
que representa o menor nível de mapeamento de colunas no 
Oracle. 

ocicommit Confirma as transações atuais. 

ocidefinebyname Obtém uma coluna do resultado, armazenando-a em uma 
variável do PHP. 

ocierror Retorna um array associativo contendo informações sobre 
o último erro ocorrido, 

ociexecute Executa um comando. 

ocifetch Obtém a linha seguinte no buffer de resultados. 

ocifetchinto Obtém a linha seguinte do resultado como um array. 

ocifetchstatement Obtém todas as linhas do resultado como um array. 

ocifreecol lection Exclui um objeto de uma coleção. 

ocifreecursor Libera todos os recursos associados a um cursor. 

ocifreedesc Exclui o descritor de um objeto extenso. 

ocifreestatement Libera todos os recursos associados a um comando. 

ociinternaldebug Habilita ou desabilita a saída de depuração interna. 

ociloadlob Carrega um objeto extenso. 

oci logoff Encerra a conexão com um servidor Oracle. 

ocilogon Estabelece uma conexão com um servidor Oracle. 

ocinewcollection Inicializa uma nova coleção. 

ocinewcursor Retorna um novo cursor, 

ocinewdescriptor Inicializa um novo descritor de objeto ou de arquivo. 

ocinlogon Estabelece uma nova conexão com um servidor Oracle. 

ocinumcols Retorna o número colunas resultantes de um comando. 

ociparse Analisa uma consulta e retorna um comando Oracle. 

ociplogon Estabelece uma conexão persistente com um servidor Oracle. 

ociresult Retorna valores das colunas das linhas obtidas. 

ocirollback Desfaz as transações atuais. 

ocirowcount Obtém o número de linhas afetadas por uma operação. 

ocisavelob Salva um objeto extenso. 

ocisavelobfile Salva um arquivo do objeto extenso. 

ociserverversion Retorna uma string contendo informações sobre a versão do 


servidor. 
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Descrição (cont.) 


ocisetprefetch 


ocistatementtype 
ociwritelobtofile 
ociwritetemporarylob 


ODBC 


Função 


Define o número de linhas a ser obtidas no processo de pré- 
busca (prefetched). 


Retorna o tipo de um comando OCI. 
Salva o objeto extenso no arquivo. 
Escreve em um objeto (BLOB) temporário. 


Descrição 


odbc. autoconmit 


odbc. binmode 


odbc close all 
odbc close 
odhc columprivilegas 


odbc columns 


odbc. commit 

odbc connect 

odbc cursor 

odbc data source 
odbc. do 

odbc error 

odbc. errormsg 
odbc exec 

odbc execute 

odbc fetch array 
odbc fetch.into 
odbc fetch object 
odbc fetch row 
odbe field Ten 
odbc field name 
odbc. field num 
odbc field precision 
odbc field scale 


odbc field type 


Habilita o autocommit (confirmação automática das ope- 
rações realizadas sobre o banco de dados). 


Define como serão manipuladas as colunas com dados 
binários. 

Fecha todas as conexões ODBC. 

Fecha uma conexão ODBC, 


Retorna um identificador de resultado que pode ser usado 
para buscar uma lista de colunas e os privilégios associados 
a estas. 


Retorna um identificador de resultado contendo a lista dos 
nomes das colunas existentes nas tabelas especificadas. 


Confirma uma transação ODBC. 

Estabelece uma conexão com uma fonte de dados (datasource). 
Obtém o nome de um cursor. 

Retorna informações sobre a conexão corrente. 

Apelido para a função odbc. exec. 

Obtém o código do último erro ocorrido. 

Obtém a mensagem referente ao último erro ocorrido. 
Prepara e executa um comando SQL. 

Executa um comando preparado. 

Obtém uma linha do resultado como um array associativo. 
Obtém uma linha do resultado como um array 

Obtém uma linha do resultado como um objeto. 

Obtém uma linha do resultado. 

Obtém o tamanho (precisão) de um campo. 

Obtém o nome de uma coluna, 

Retorna o número de uma coluna. 

Apelido para a função odbc. field Ten. 

Obtém a escala de um campo. 

Obtém a tipo de dado de um campo, 
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Descrição (cont.) 


odbc foreignkeys 


odbc free result 
odbc gettypeinfo 


odbe Jongreadlen 
odbc next result 
odbc num fields 
odbc. num rows 
odbc. pconnect 
odbc. prepare 
odbc. primarykeys 


odbc procedurecolumas 
odbc procedures 


odbc result all 
odbc result 
odbc rolIback 
odbc setoption 


odbc specialcolumns 


odbc statistics 
odbc tableprivileges 
odbc tables 


Função 


Retorna a lista de chaves estrangeiras na tabela especificada 
ou em outras tabelas que referenciam sua chave primária. 


Libera os recursos associados ao resultado. 


Retorna um identificador de resultado contendo informações 
sobre os tipos de dados suportados pela fonte de dados (data 
source). 


Manipulador de colunas do tipo LONG. 

Verifica se estão disponíveis múltiplos resultados. 
Retorna o número de colunas existentes em um resultado. 
Retorna o número de linhas existentes em um resultado. 
Abre uma conexão persistente com o banco de dados. 
Prepara um comando para execução. 


Retorna um identificador de resultado, que pode ser usado 
para buscar os nomes das colunas que compõem a chave 
primária da tabela. 


Retorna informações sobre parâmetros de um procedimento. 


Retorna um identificador de resultado contendo a lista de 
procedimentos armazenados em uma determinada fonte de 


dados. 

Exibe o resultado como uma tabela HTML. 
Obtém os dados do resultado. 

Desfaz uma transação. 


Ajusta as configurações ODBC. Se algum erro ocorrer, retorna 
FALSE. 


Retorna o melhor conjunto de colunas que identifica de 
forma única uma linha da tabela, ou as colunas que são 
atualizadas automaticamente quando algum valor na linha 
é modificado por uma transação. 


Retorna estatísticas sobre uma tabela. 
Lista as tabelas e os privilégios associados a cada uma delas. 


Retorna um identificador de resultado contendo a lista dos 
nomes das tabelas armazenadas em uma determinada fonte 


de dados. 


Opções e informações do PHP 


Descrição 


assert 
assert options 
extension loaded 


Checa se uma declaração é falsa. 
Define/obtém diversas flags sobre o assert. 


Verifica se uma extensão foi carregada. 
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Função 
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Descrição (cont.) 


d] 

getenv 

get cfg var 

get current user 

get defined constants 


get loaded extensions 
get extension funcs 


get required files 


get.included files 


get. magic quotes .gpc 


Carrega uma extensão do PHP em tempo de execução. 
Obtém o valor de uma variável de ambiente. 

Obtém o valor de uma opção de configuração do PHP, 
Obtém o nome do dono do script PHP corrente. 


Retorna um array associativo com os nomes e valores das 
constantes definidas. 


Retorna um array com o nome dos módulos carregados. 
Retorna um array com os nomes das funções de um módulo. 


Retorna um array com os nomes dos arquivos requeridos 
em um script. 


Retorna um array com os nomes dos arquivos incluídos em 
um script. 


Retoma a configuração ativa. 


get magic quotes runtimeRetorna a configuração ativa de magic quotes runtime. 


getlastmod 
getmygid 


getmyinode 
getmypid 
getmyuid 
getopt 


getrusage 
ini.alter 
iniiget al] 
ini get 

ini restore 
ini set 


php ini scanned files 


phperedits 
phpinfo 
phpversion 
php logo guid 
php sapi. name 
php uname 


putenv 


Retorna a hora de modificação da última página. 


Retorna o identificador do grupo (GID) do proprietário do 
script corrente. 


Retorna o inode do script corrente. 
Retorna o ID do processo PHP. 
Retorna o UID do dono do script, 


Retorna um array associativo com pares opções/argumentos, 
baseado na lista de argumentos da linha de comando. 


Obtém os recursos que estão sendo usados. 

Altera o valor de uma opção de configuração. 

Obtém o valor de todas as opções de configuração. 
Obtém o valor de uma determinada opção de configuração. 
Restaura o valor de uma opção de configuração. 

Define o valor de uma opção de configuração. 


Retorna uma lista de arquivos .ini analisados após o php. 
ini. Os elementos são separados por vírgulas. 


Imprime os créditos do PHP 

Imprime informações sobre o PHP. 

Retorna a versão do PHP, 

Obtém o logo guid. 

Retorna o tipo de interface entre o servidor web e o PHP 
Retorna informações sobre o sistema operacional. 
Define o valor de uma variável de ambiente. 


set magic quotes runtime Define a configuração ativa de magic quotes. runtime. 


set time limit 


Limita o tempo máximo de execução, 


Função 
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Descrição (cont.) 


version compare 


zend logo guid 


zend version 


Oracle 


Compara duas strings padronizadas, contendo o número da 
versão do PHP. 


Obtém o zend guid. 
Obtém a versão da ferramenta Zend. 


Função Descrição 

ora bind Associa uma variável PHP a um parâmetro do Oracle. 

ora close Fecha um cursor. 

ora columnname Obtém o nome de uma coluna do resultado. 

ora colunnsize Obtém o tamanho de uma coluna do resultado. 

ora columtype Obtém o tipo de uma coluna do resultado. 

ora commit Confirma uma transação, 

ora. comi toff Desabilita a confirmação automática (autocommit). 

ora commiton Habilita a confirmação automática (autocommib). 

ora do Combinação das funçõesora parse,ora execeora fetch. Analisa 
e executa um comando e, logo após, obtém a primeira linha do 
resultado. 

ora error Retorna uma mensagem de erro do Oracle. 

ora errorcode Retorna um código de erro do Oracle. 

ora exec Executa um comando analisado em um cursor. 


ora fetch Into 


ora fetch 

ora getcolumn 
ora Togoff 
ora logon 

ora numcols 
ora numrows 
ora open 

ora parse 


ora plogon 
ora rollback 


Obtém uma linha do resultado, atmazenando-a no array espe- 
cificado. 


Busca uma linha a partir de um determinado cursor. 
Obtém os dados de uma determinada coluna. 

Fecha uma conexão com o Oracle, 

Abre uma conexão com o Oracle. 

Retorna o número de colunas resultantes. 

Retorna o número de linhas resultantes. 

Abre um cursor. 


Analisa um comando SQL, associando-o a um determinado 
cursor. 


Abre uma conexão persistente com o Oracle. 


Desfaz uma transação. 
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PDF 


Função 

pdf activate item 

pdf add nameddest 

pdf add table cell 
pdf add textflow 


pdf add thumbnail 
pdf arc 

pdf arcn 

pdf begin document 
pdf begin font 

pdf begin glyph 
pdf begin item 

pdf begin layer 
pdf. begin page ext 
pdf begin pattern 


pdf begin template ext 
pdf circle 

pdf clip 

pdf close image 

pdf close pdi page 


pdf closepath fill. stroke 


pdf closepath stroke 


pdf closepath 


pdf. conçat 


pdf. continue text 
pdf create action 
pdf create annotation 
pdf create bookmark 
pdf. create field 

pdf create fieldgroup 
pof. create gstate 

pdf create pvf 


PHP para quem conhece PHP 


Descrição 


Ativa um elemento de estrutura ou outro item de conteúdo. 
Cria um destino nomeado. 
Adiciona uma célula a uma tabela nova ou já existente. 


Cria um objeto de fluxo de texto ou adiciona um texto a um 
objeto já existente. 


Adiciona à página corrente uma miniatura (thumbnail). 
Desenha um arco em sentido anti-horário. 

Desenha um arco em sentido horário. 

Cria um novo arquivo PDF. 

Inicia uma definição de fonte Tipo 3. 

Inicia uma definição glyph para uma fonte Tipo 3. 

Abre um elemento da estrutura ou outro item de conteúdo. 
Inicia uma camada. 

Inicia uma nova página. 


Inicia a definição de um novo padrão (pattern), que poderá 
ser utilizado para o preenchimento de objetos. 


Inicia a definição de um novo modelo (template). 
Desenha um círculo. 

Seleciona o caminho atual, definindo-o como clip path. 
Fecha uma imagem. 

Fecha uma página aberta com a função pdf open pdi. page. 


Completa o caminho corrente (adicionando uma linha do 
último ao primeiro ponto), preenchendo-o e desenhando-o 
no documento. 


Completa o caminho corrente (adicionando uma linha do 
último ao primeiro ponto) e o desenha no documento, 


Completa o caminho corrente adicionando uma linha do 
último ao primeiro ponto. 


Concatena uma matriz à atual matriz utilizada para trans- 
formação de textos e gráficos (CTM). 


Escreve um texto na linha seguinte do documento. 
Cria ações para objetos ou eventos. 

Cria anotações retangulares, 

Cria um bookmark na página corrente. 

Cria um campo de formulário. 

Cria um grupo de campos em um formulário. 
Cria o estado gráfico de um objeto. 

Cria um arquivo virtual PDFlib. 


Função 


Apêndice A a Comandos gerais do PHP 489 


Descrição (cont.) 


pdf create. textilow 
pdf. curveto 


pdf define layer 
pdf.delete pvf 

pdf delete textflow 
pdf. delete 


pdf encoding set. char 


pdf. end document 
pdf.end font 

pdf end glyph 
pdf end item 


pdf.end layer 
pdf. end page ext 
pdf. end pattern 


pif end template 


pdf. endpath 
pdf fill. imageblock 
pdf fill. pdfblock 
por fill stroke 
pdf fi textblock 
pdf fil 

pof.fit image 
pof.fit pdi page 
pdf. fit texthow 
pdf fit textline 
pdf. get. apiname 
pdf. get buffer 


pdf get errmsg 
pof. get errnum 
pdf get parameter 
pdf get value 


pif info font 


Cria um objeto de fluxo de texto. 


Desenha uma curva Bezier a partir do ponto corrente, utili- 
zando outros três pontos de controle. 


Cria a definição de uma camada (layer). 
Exclui um arquivo virtual PDFlib. 
Exclui um objeto de fluxo de texto. 


Exclui um objeto PDF e libera todos os recursos associados 
a este. 


Adiciona um nome glyph e/ou um valor Unicode ao docu- 
mento. 


Fecha um arquivo PDF. 
Encerra uma definição de fonte Tipo 3. 
Encerra uma definição glyph para fontes Tipo 3. 


Fecha o elemento de estrutura ou item de conteúdo especi- 
ficado. 


Desativa todas as camadas ativas. 
Encerra uma página. 


Encerra a definição de um padrão, iniciada pela função 
pdf. begin pattern. 


Encerra a definição de um modelo (template), iniciada pela 
função pdf begin template. 


Encerra o caminho corrente. 

Preenche um bloco de imagem com dados variáveis. 
Preenche um bloco PDF com dados variáveis. 
Preenche o caminho atual e o desenha no documento. 
Preenche um bloco de texto com dados variáveis. 
Preenche o caminho atual. 

Posiciona uma imagem ou template. 

Insere uma página PDF importada. 

Formata um fluxo de texto em uma área retangular. 
Posiciona uma linha simples de texto. 

Obtém o nome de uma função API. 


Obtém o conteúdo do buffer onde estão localizados os dados 
referentes ao documento PDF gerado. 


Retorna a mensagem referente ao erro ocorrido. 
Retorna o número referente ao erro ocorrido. 
Obtém o valor de um determinado parâmetro do documento. 


Obtém o valor de um determinado parâmetro numérico do 
documento, 


Retorna informações detalhadas sobre uma fonte carregada. 
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Descrição (cont.) 


pdf info matchhox 
pdf info table 
pdf info. textflow 
pdfinfo textline 
pdf initgraphics 


pdf. Jineto 

pdf. load 3ddata 
pdf. load. font 
pdf load iccprofile 


pdf load. image 
pdf makespotcolor 


pdf moveto 

pf new 

pdf. open pdi page 
pdf. pcos get number 


pdf.pcos get stream 
pdf pcos get string 


pdf. process. pdi 
pdf. rect 
pdf restore 


pdf resume page 
pdf rotate 

pdf save 

pdf. scale 

pdf set gstate 
pdf set info 


Consulta informações de uma matchbox. 
Retorna informações sobre uma tabela, 

Retorna o estado de um objeto de fluxo de texto. 
Realiza formatação de linhas de texto. 


Reinicia todos os parâmetros gráficos e de cores, fazendo-os 
assumir seus valores-padrão. 


Desenha uma linha. 
Carrega um modelo 3D do disco ou de um arquivo virtual. 
Busca e prepara uma fonte para uso. 


Busca e prepara um perfil de cores ICC (International Color 
Consortium) para uso. 


Abre um arquivo de imagem. 


Define a cor atual como sendo uma cor especial chamada 
spot. 


Define o ponto corrente. 
Cria um novo objeto PDF. 
Abre uma página no documento PDI especificado. 


Obtém o valor do caminho pCOS com o tipo number ou 
boolean. 


Obtém o conteúdo do caminho pCOS com o tipo stream, 
fstream ou string. 


Obtém o valor do caminho pCOS com o tipo name, string 
ou boolean. 


Processa um documento PDF importado. 
Desenha um retângulo. 


Restaura o último estado dos gráficos salvo pela função 
pdf save. 


Reinicia uma página. 

Realiza uma rotação no sistema de coordenadas 
Salva o estado gráfico corrente do documento. 
Define a escala do sistema de coordenadas. 
Ativa o estado gráfico do objeto. 


Defineoscampos de informação sobre um documento, queserão 
exibidos quando o usuário visualizar suas propriedades. 


pdf-set layer dependency Define o relacionamento entre as camadas do documento. 


pdf set parameter 
pdf..set text pos 
pdf set value 


pdf setcolor 


Altera o valor de um determinado parâmetro do documento. 
Define a posição corrente para inserir textos no documento. 


Altera o valor de um determinado parâmetro numérico do 
documento 


Define a cor de preenchimento ou de contorno. 


Função 
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pdf setdash 
pdf setdashpattern 
pdf. setflat 


pof. setfont 
pdf setlinecap 


pdf..setlinejoin 
pdf setlinewidth 


pdf setmatrix 
pdf setmiterlimit 


pdf shading pattern 
pdf shading 


pdf_shfili 
pdf show xy 


pdf. show 


pdf. skew 


pdf stringwidth 


pdf. stroke 

pdf. suspend page 
pdf translate 

pdf utfl6 to utfB 
pdf utf32 to utfi6 
pdf.utfê to utfl6 


PostgreSQL 


Função 


Define o padrão de pontilhado. 
Define o padrão de pontilhado. 


Define a distância máxima (flatness) entre o caminho de um 
objeto e uma aproximação criada com linhas. 


Define a fonte corrente, assim como seu tamanho. 


Altera o valor do parâmetro linecap, que faz que a linha seja 
desenhada de forma diferente. 


Configura o tipo de junção entre duas linhas. 


Define a espessura da linha que será utilizada para desenhar 
as figuras. 


Define a matriz corrente para transformações. 


Configura o limite miter para um valor maior que ou igual 
al, 


Define o padrão de sombreado. 


Define uma mistura da cor corrente de preenchimento com 
outra cor. 


Preenche uma área com sombreamento. 


Escreve um texto em um determinado ponto do documento, 
utilizando a fonte corrente. 


Escreve um texto no ponto corrente do documento, utilizando 
a fonte corrente. 


Inclina o sistema de coordenadas do documento nos eixos 
xey 

Retorna a largura de um texto utilizando uma determinada 
fonte. 

Desenha uma linha em torno do caminho corrente. 
Suspende uma página. 

Define a origem do sistema de coordenadas. 

Converte uma string de UTF-16 para UTF-8. 

Converte uma string de UTF-32 para UTF-16. 

Converte uma string de UTF-8 para UTF-l6. 


Descrição 


pg.affected rows 


pa cancel query 


Retorna o número de registros afetados por uma operação 
INSERT, UPDATE ou DELETE. Antigamente, essa função era 
chamada de pg cmdtuples (). 

Cancela uma consulta assíncrona enviada pela função pg send. 
query O. 


492 


Função 


PHP para quem conhece PHP 


Descrição (cont.) 


pg-client encoding 


pa-close 
pg connect 


pg connection busy 
po.connection reset 


pg. connection status 


pg convert 


pa copy from 
pa-copy.to 

pg. dbname 

pg. delete 

pa end copy 
pgescape bytea 


pg.escape string 
pg execute 


po fetch all 


pg fetch array 


po fetch all columns 


pg fetch assoc 
pg fetch object 
pg fetch result 


pg fetch row 
pa field is null 
pg field. mame 
pofield num 
pa.fietd prtlen 
po field size 

pa field table 
po field type oid 
pg feldtype 

po free result 
pg-get notify 


Retorna a codificação de caracteres usada pelo cliente. 
Fecha uma conexão PostgreSQL. 

Abre uma conexão PostgreSQL. 

Verifica se uma conexão está ocupada ou não. 

Reinicia uma conexão. É útil para recuperação de erros. 


Retorna o estado da conexão (PGSQL CONNECTION. OK ou PGSQL 
CONNECTION BAD). 


Converte os valores de um array associativo para uso em um 
comando SQL. 


Insere registros em uma tabela a partir de um array 

Copia o conteúdo de uma tabela para um array. 

Retorna o nome do banco de dados. 

Exclui registros de acordo com uma determinada condição. 
Sincroniza com o backend do PostgreSQL. 


Adiciona caracteres de escape a uma string do tipo de dados 
bytea. 


Adiciona caracteres de escape a uma string. 


Envia uma requisição para executar um comando preparado 
com os parâmetros fornecidos, aguardando o resultado. 


Retorna um array contendo todas as linhas resultantes de uma 
consulta. 


Retorna uma linha do resultado como um array. 


Retorna um array com todas as linhas de uma determinada 
coluna do resultado. 


Retorna uma linha do resultado em um array associativo. 
Retorna uma linha do resultado como um objeto. 

Retorna valores a partir de um recurso do tipo result, retornado 
pela função pg quervO. 

Retorna uma linha do resultado como um array enumerado. 
Testa se um campo é nulo. 

Retorna o nome do campo. 

Retorna o número do campo. 

Retorna o tamanho do campo para impressão. 

Retorna o tamanho do campo definido no banco de dados. 
Retorna o nome ou identificador da tabela do campo. 
Retorna o identificador do tipo (OID) do campo indicado. 
Retorna o tipo de dado de um campo da consulta, 

Libera a memória alocada para uma consulta. 


Obtém o estado da conexão enviando um comando SOL 
NOTIFY. 


Função 
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pg get pid 
po.get. result 


pa host 
pg_insert 

pg last error 
pg last notice 
po-last oid 
pachost 

polo close 
pa.lo create 
pa lo export 
pg lo import 
pg lo open 
pg. lo. read 
polo read all 
polo seek 
pa lo teh 
polo untink 
pg lo write 
pq .meta data 
pg num fields 
po num. rows 
pg-options 


pg. parameter status 


pa pronnect 
pg-ping 


po port 
pa prepare 


po.put line 
pg query 


pg query params 


pg result error 


Retorna o identificador do processo (PID) do servidor de banco 
de dados. 


Obtém os resultados de uma consulta assincrona, executada 
pela função pg. send query. 


Retorna o nome do servidor associado à conexão. 

Insere os valores de um array associativo em uma tabela. 
Obtém a última mensagem de erro para a conexão especificada. 
Retorna a última mensagem gerada pelo servidor PostgreSQL. 
Retorna o último identificador do objeto (OTD). 

Retorna o nome do host associado com a conexão. 

Fecha um objeto extenso (large object). 

Cria um objeto extenso. 

Exporta um objeto extenso para um arquivo. 

Importa um objeto extenso de um arquivo. 

Abre um objeto extenso. 

Lê um objeto extenso. 

Lê um objeto extenso inteiro. 

Busca uma posição em um objeto extenso. 

Retorna a posição corrente em um objeto extenso. 

Exclui um objeto extenso. 

Escreve em um objeto extenso. 

Obtém os metadados para uma determinada tabela. 
Retorna o número de campos de uma consulta. 

Retorna o número de linhas de uma consulta. 

Obtém opções associadas com uma conexão. 

Busca um parâmetro da configuração corrente do servidor. 
Abre uma conexão persistente com um servidor PostgreSQL. 


Envia um ping para verificar se a conexão com 0 servidor está 
ativa. Se não estiver, tenta reconectar automaticamente. 


Retorna o número da porta associado com a conexão. 


Envia uma requisição para criar um comando preparado com 
os parâmetros fornecidos, aguardando a conclusão. 


Envia string terminada em NULL para o backend do PostgreSQL. 


Executa uma consulta. Antigamente, essa função era chamada 
de pg exec(). 


Envia um comando ao servidor e espera o resultado, permitindo 
passar parâmetros separadamente do comando SQL. 


Obtém a mensagem de erro associada ao resultado. 


pg result error field Retorna um campo com uma mensagem de erro detalhada 


associada ao resultado. 
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Função Descrição (cont.) 

py result seek Configura o offset interno das linhas do resultado. 

po result status Obtém o estado do resultado de uma consulta. 

po select Seleciona registros de acordo com uma determinada condição. 
pg send execute Envia uma requisição para executar um comando preparado 


com os parâmetros fornecidos, sem esperar os resultados. 


pg send prepare Envia uma requisição para criar um comando preparado com 
os parâmetros fornecidos, sem esperar a conclusão. 


po send query Envia uma consulta assíncrona ao servidor. Os resultados são 
obtidos posteriormente pela função pg get resultO. 


pg-send query params Envia um comando e separa os parâmetros para o servidor, sem 
esperar os resultados, 


pa set client encoding Define a codificação do cliente. 


pg set error verbosity Controla a exibição das mensagens retornadas pelas funções 
pg last error() e pg result error(). 


pg_trace Habilita o tracing em uma conexão PostgreSQL. 

patransaction status Retorna o estado de transação corrente do servidor. 

po. tty Retorna o nome do terminal associado a uma conexão. 

pg unescape bytea Remove caracteres de escape de uma string do tipo de dados 
bytea. 

pg-untrace Desabilita o tracing de uma conexão PostgreSQL. 

paupdate Atualiza registros em uma tabela de acordo com uma determi- 


nada condição. 


pg. version Retorna um array com o cliente, protocolo e versão do servidor 
(quando disponível). 


Sessões 
Função Descrição 
session start Inicializa uma sessão, 
session destroy Destrói todos os dados registrados em uma sessão. 
session name Obtém e/ou define o nome da sessão corrente, 
session module. name Obtém e/ou define o módulo da sessão corrente. 
session save path Obtéme/oudefineo caminho de ondeserão armazenados 

os dados da sessão corrente. 

session id Obtém e/ou define o ID da sessão corrente. 
session regenerate id Gera um novo identificador para a sessão corrente. 
session register Registra uma ou mais variáveis na sessão corrente. 


session unregister Exclui uma variável da sessão corrente. 


Função 
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session unset 

session.is registered 
session get cookie params 
session set cookie params 
session decode 

session encode 

session set save handler 


session cache limiter 
session cache expire 


session write close 


Limpa todas as variáveis da sessão. 

Verifica se uma variável está registrada em uma sessão. 
Obtém parâmetros dos cookies da sessão. 

Define parâmetros dos cookies da sessão. 

Decodifica dados da sessão em uma string. 

Codifica dados da sessão corrente em uma string. 


Define funções de armazenamento da sessão em nível de 
usuário. 


Obtém e/ou define o limitador atual da cache. 
Retorna o tempo (em minutos) de expiração da cache. 


Encerra a sessão corrente e armazena seus dados. 


Sistema de arquivos (Filesystem) 


Função Descrição 

basename Retorna o nome do arquivo em um caminho. 

chgrp Altera o grupo de um arquivo. 

chmod Altera as permissões de um arquivo. 

choun Altera o dono de um arquivo. 

clearstatcache Limpa a cache do arquivo. 

copy Copia arquivos, 

delete Exclui um arquivo. 

dirname Retorna o nome do diretório contido em um caminho. 
diskfreespace Retorna o espaço disponível em um diretório. 


disk total space 
diskfreespace 
fclose 

feof 

fflush 

fgetc 

fgetcsv 

fgets 

fgetss 

file 

file_exists 

file get contents 
file put contents 
fileatime 


Retorna o tamanho total de um diretório. 

Apelido (alias) para a função disk free space). 

Fecha um ponteiro de arquivo. 

Testa se o ponteiro está no final do arquivo. 

Grava os dados da memória em um arquivo. 

Obtém caracteres a partir da posição do ponteiro. 
Obtém uma linha do arquivo e converte em campos CSV. 
Obtém uma linha do arquivo. 

Obtém uma linha do arquivo e retira as tags HTML. 
Lê um arquivo inteiro e o armazena em um array 
Testa se determinado arquivo existe. 

Lê o conteúdo inteiro de um arquivo para uma string. 
Escreve uma string em um arquivo. 


Obtém a hora do último acesso ao arquivo. 
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filectime 
fitegroup 
fileinode 
filemtime 
fileouner 
fileperms 
filesize 
filetype 
flock 
fnmatch 


fopen 
fpassthru 
fputs 
fread 
fscanf 


fseek 
fstat 
ftell 
ftruncate 
fwrite 
glob 


is dir 

is. executable 
isfile 

is link 

is. readable 

is writable 

is writeable 

is uploaded file 
Tchgrp 

Tchown 

Tink 

Tinkinfo 

mkdir 

move. uploaded. file 
parse ini file 


Obtém a hora de alteração do descritor do arquivo. 
Retorna o grupo do arquivo. 

Retorna o inode do arquivo, 

Retorna a hora em que o arquivo foi modificado. 
Retorna o dono do arquivo. 

Retorna as permissões do arquivo. 

Retorna o tamanho do arquivo. 

Obtém o tipo do arquivo. 

Bloqueia um arquivo. 


Testa se o nome do arquivo possui um determinado padrão 
(pattern). 


Abre um arquivo ou um URL, 

Imprime os dados restantes de um arquivo. 
Escreve em um arquivo. 

Lê um arquivo (binário). 


Interpreta a entrada de um arquivo conforme determinado 
formato. 


Posiciona o ponteiro do arquivo em um local determinado. 
Obtém informações sobre um arquivo. 

Retorna a posição do ponteiro do arquivo. 

Trunca um arquivo em determinado tamanho. 

Escreve em um arquivo. 


Busca por diretórios e arquivos que possuem um determinado 
padrão (pattern). 


Testa se o arquivo é um diretório. 

Testa se o arquivo é executável. 

Testa se o arquivo é regular. 

Testa se o arquivo é um link simbólico. 

Testa se o arquivo tem permissão de leitura. 

Testa se o arquivo tem permissão de escrita. 

Tem a mesma função do comando is writable. 
Testa se o arquivo foi enviado por upload via HTTP POST. 
Altera o grupo proprietário de um link simbólico. 
Altera o usuário proprietário de um link simbólico. 
Cria um link físico. 

Obtém informações sobre um link. 

Cria um diretório. 

Move um arquivo enviado por upload. 

Analisa um arquivo de configuração (ini). 
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pathinfo Retorna informações sobre o caminho (path). 
pclose Fecha o ponteiro para um processo, 

popen Abre o ponteiro para um processo. 

readfile Lê um arquivo e o imprime na saída-padrão 
readlink Retorna o alvo de um link simbólico. 

rename Renomeia um arquivo. 

rewind Retrocede a posição de um ponteiro de arquivo. 
rmdir Remove um diretório, 

stat Obtém informações sobre um arquivo, 

Istat Obtém informações sobre um link simbólico. 
realpath Retorna o nome absoluto do caminho. 


set file buffer 


Strings 


Configura o buffer de arquivo. 


symlink Cria um link simbólico. 

tempnam Cria um nome único de arquivo. 

tmpfile Cria um arquivo temporário. 

touch Define a hora de modificação de um arquivo. 

umask Altera a máscara atual. 

unlink Exclui um arquivo. 

Função Descrição 

addCSlashes Coloca uma barra invertida (4) antes de determinados ca- 
racteres. 

addSlashes Coloca \ antes dos caracteres *,“ er. 

binZhex Converte um dado de binário para hexadecimal. 

chop Remove espaços e quebras de linha do final da string. 

chr Retorna um caractere específico. 


chunk split 


convert cyr string 


count. chars 


cre32 
crypt 
echo 
explode 


Divide uma string em pequenos pedaços. 

Converte um caractere do tipo Cyrillic para outro. 

Retorna informações sobre caracteres usados em uma 
string. 

Calcula o crc32 polinomial de uma string. 

Codifica uma string. 

Imprime uma string em determinada saída. 


Forma um array através de uma string. 


get html translation table Retorna a tabela de tradução usada pelas funções 


htmlspecialchars() e htmlentitiesQ. 
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hebrey 


hebrevc 


html entity decode 


htmlentities 


htmlspecialchars 


implode 


join 
Tevenshtein 


localeconv 


Trim 
mdS file 


md5 
metaphone 
money format 
ni langinto 


ni2br 


number format 


ord 

parse str 
print 
printf 


quoted printable decode 


quotemeta 


rtrim 


sscanf 
setlocale 
shall file 


shal 


PHP paro quem conhece PHP 


Descrição (cont.) 


Converte texto lógico Hebrew para texto visual. 


Converte texto lógico Hebrew para texto visual convertendo 
o caractere An para “<br> n”, 


Converte todas entidades HTML para seus respectivos ca- 
racteres. 


Converte todos os caracteres aplicáveis para entidades 
HTML. 


Converte caracteres especiais para entidades HTML. 


Forma uma string por meio da união dos elementos de um 
array. 


Tem a mesma função do implode. 
Calcula a distância Levenshtein entre duas strings. 


Retorna um array contendo informações numéricas e mo- 
netárias. 


Remove espaços em branco do início de uma string. 


Calcula o hash MDS de um determinado nome de arqui- 
vo. 


Calcula o hash MDS de uma string. 
Calcula a chave metaphone de uma string. 
Aplica um determinado formato de moeda a um número. 


Retorna informações sobre algumas configurações do sistema, 
como formatos e localidade. 


Insere quebras de linha HTML antes de todas as quebras de 
linha de uma string. 


Formata um número, permitindo definir o separar decimal 
e de milhar. 


Retorna o valor ASCII de um caractere. 

Divide uma string em variáveis. 

Imprime o valor de uma string. 

Imprime o valor de uma string com formatação. 
Converte uma string para 8 bits. 

Coloca o caractere \ antes de determinados caracteres. 


Remove espaços no final da string, incluindo quebras de 
linha. 


Divide uma string de acordo com um formato. 
Ajusta informações do local. 


Calcula o hash shal (Secure Hash Algorithm 1) de um de- 
terminado arquivo. 


Calcula o hash shal (Secure Hash Algorithm 1) de uma 


string. 


Função 
simitar text 
soundex 
sprintf 


str ireplace 


str rotl3 
str shuffle 


str_split 
str word count 


strncasecmp 


strcasecmp 


substr compare 


strchr 
strcmp 
strcoll 
strespn 


strip tags 
stripeslashes 


stripslashes 
stristr 
strpbrk 


strlen 
strnatemp 


strnatcasecktp 


strncmp 
str pad 
strpos 
strrchr 
str repeat 
strrev 


strrpos 
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Calcula a similaridade entre duas strings. 
Calcula a chave soundex de uma string, 
Retorna uma string formatada. 


Versão case-insensitive (não diferencia maiúsculas de mi- 
núsculas) da função str replace). 


Realiza uma transformação rot13 em uma string. 


Retorna uma string com a posição de seus caracteres alterada 
de forma aleatória. 


Converte uma string para array. 
Conta o número de palavras existentes em uma string. 


Comparação binária (case-insensitive) dos n primeiros 
caracteres. 


Comparação binária (case-insensitive). 


Comparação binária case insensitive de duas strings, a partir 
de uma posição (offset). 


Encontra a primeira ocorrência de um caractere. 
Comparação binária. 
Compara duas strings no local corrente. 


Encontra o tamanho do segmento inicial da string que não 
contém a máscara de comparação. 


Retira tags HTML e PHP de uma string, 


Retira o caractere \ colocado com o comando 
addcslashes (). 


Retira o caractere \ colocado com o comando addslashes 0. 
Versão case-insensitive do comando strstrQ). 


Procura em uma string qualquer caractere de um determinado 
conjunto. 


Obtém o tamanho de uma string. 
Compara strings usando o algoritmo “natural order” 


Faz uma comparação case-insensitive de strings usando o 
algoritmo “natural order” 


Comparação binária dos n primeiros caracteres. 

Preenche um certo tamanho da string com outra string, 
Encontra a posição da primeira ocorrência de uma string. 
Encontra a última ocorrência de um caractere. 

Repete uma string. 

Reverte uma string. 


Encontra a posição da última ocorrência de um caractere 
em uma string, 
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Encontra o tamanho do segmento inicial da string que 


Função Descrição (cont.) 
strspn 

contém a máscara de comparação. 
strstr Encontra a primeira ocorrência de uma string. 
strtok Divide uma string em partes conforme um parâmetro. 
strtolower Transforma uma string em letras minúsculas. 
strtoupper Transforma uma string em letras maiúsculas. 


str_replace 
strtr 

substr 

substr count 
substr replace 
trim 

ucfirst 


ucwords 
vprintf 
vsprintf 


wordwrap 


Sybase 


Função 


Substitui todas as ocorrências de uma string por outra. 
Substitui alguns caracteres por outros. 

Retorna uma parte da string. 

Conta o número de ocorrências de uma substring, 
Substitui textos dentro de uma substring. 

Remove os espaços em branco do início e do fim da string. 


Transforma o primeiro caractere de uma string em maiús- 
culo. 


Transforma em maiúsculo o primeiro caractere de cada 
palavra contida em uma string. 


Exibe os valores de um array de acordo com o formato 
especificado. Não possui valor de retorno. 


Retorna os valores de um array de acordo com o formato 
especificado. 


Coloca quebras de tinha em uma string após determinado 
número de caracteres. 


Descrição 


sybase affected rows 


sybase close 
sybase connect 
syvbase data seek 


Retorna o número de linhas afetadas na última opera- 
ção. 

Fecha uma conexão com o Sybase. 

Abre uma conexão com o Sybase. 

Move o ponteiro interno das linhas. 


sybase deadlock retry count Define o número de tentativas que devem ser feitas em 


sybase fetch array 
sybase fetch assoc 
sybase fetch field 
sybase fetch object 
sybase fetch..row 


caso de deadlock. 

Obtém uma linha como um array. 

Obtém uma linha como um array associativo. 
Obtém informações sobre determinados campos. 
Obtém uma linha como um objeto. 


Obtém uma linha como um array utilizando índices 
numéricos. 
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Função Descrição (cont) 
sybase. field seek Define o offset de um campo. 
sybase free result Libera a memória alocada para armazenar um resultado. 


sybase get last message Retorna a última mensagem gerada pelo servidor. 
sybase min client severity Define o nível de severidade mínima para um cliente. 
sybase min error severity Define o nível de severidade minima para erros. 
sybase min message. severity Define o nível de severidade mínima para mensagens. 
sybase min server severity Define o nível de severidade mínima do servidor. 


sybase num fields Retorna o número de campos existentes em um resultado. 
sybase num rows Retorna o número de linhas existentes em um resultado. 
sybase. pconnect Abre uma conexão persistente com o Sybase. 

sybase query Envia uma consulta ao Sybase. 

sybase result Obtém dados do resultado. 

sybase select. db Seleciona um banco de dados Sybase. 


sybase set message handler Permite definir uma função para ser chamada quando o 
servidor gerar alguma mensagem. 


sybase unbuffered query Envia uma consulta ao Sybase e não realiza bloqueio. 


URL 


Função Descrição 
base64 decode Decodifica dados codificados com MIME base64. 
base64 encode Codifica dados com MIME base64. 


parse ur] Separa uma URL e retorna seus componentes. 
urldecode Decodifica uma URL codificada. 
urlencode Codifica uma URL. 
Variáveis 
Função Descrição 
doubleval Retorna o valor de uma variável em ponto flutuante. 
empty Testa se o conteúdo de uma variável é nulo. 
floatva] Obtém o valor de uma variável em ponto flutuante. 
gettype Obtém o tipo da variável. 
get. defined vars Retorna um array com todas as variáveis definidas. 


get resource type Retorna o tipo do recurso. 
import. request variables Importa as variáveis GET/POST/Cookie em um escopo global. 
intval Retorna o valor inteiro de uma variável. 
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Função Descrição (cont.) 
is array Testa se uma variável] é um array. 
is. boo] Testa se uma variável é do tipo bool. 


is callable 


is. double 
is float 
is_int 

is. integer 
is. long 

is null 
is_numeric 
is_object 
is_real 

is. resourçe 
is scalar 
is string 
isset 
printr 
serialize 
settype 
strval 
unserialize 
unset 
var_dump 


var_export 


Verifica se o conteúdo de uma variável pode ser chamado como 
uma função. 


Testa se uma variável é do tipo double. 

Testa se uma variável é do tipo ponto flutuante. 

Testa se uma variável é do tipo inteiro. 

Testa se uma variável é do tipo inteiro, 

Testa se uma variável é do üpo inteiro. 

Testa se uma variável é nula. 

Verifica se uma variável é um número ou uma string numérica. 
Testa se uma variável é um objeto. 

Testa se uma variável é do tipo real. 

Testa se uma variável é um recurso. 

Testa se uma variável é escalar. 

Testa se uma variável é uma string. 

Verifica se uma variável está definida. 

Imprime informações sobre uma variável. 

Gera uma representação armazenável de um valor, 

Define o tipo de uma variável. 

Retorna a variável como uma string. 

Cria um valor em PHP para uma representação armazenada. 
Exclui uma variável do programa. 

Retorna informações sobre uma variável. 


Retorna uma representação estruturada de uma determinada 
variável. 


Apêndice B 
Novidades do PHP 5 e PHP 6 


Após três anos do lançamento do PHP 5, que ocorreu em 2004, a equipe do PHP 
resolveu descontinuar a versão anterior, ou seja, não serão lançados novos releases 
do PHP 4. A decisão foi tomada porque o PHP 5 já era considerado estável e pronto 
para produção. Além disso, o PHP 6 também estava bem encaminhado. 


Aversão 5 do PHP trouxe diversos recursos novos aos desenvolvedores web, além 
de algumas mudanças que melhoraram o desempenho da linguagem. Por meio da 
leitura deste apêndice, você irá conhecer algumas das novas funcionalidades das 
últimas versões do PHP, assim como os motivos que levaram os desenvolvedores 
do PHP a implementá-las. 


O que mudou a partir do PHP 5? 


Uma das principais mudanças da versão 5 foi o amadurecimento do PHP no que 
diz respeito à programação orientada a objetos (OOP). A partir dessa versão, o PHP 
passou a operar com a Zend Engine 20, utilizando um novo modelo de objetos. Esse 
modelo conferiu ao PHP em termos de QOP, significativos ganhos de velocidade e 
performance, visto que é mais otimizado e realiza muito menos cópias redundantes 
de dados, como ocorria no modelo antigo. 


Apesar de esse novo modelo de QOF ser a mudança mais radical do PHP 5, tam- 
bém foram acrescentados outros recursos interessantes nessa versão. Entre eles, uma 
ferramenta embutida para trabalhar com bancos de dados SQL chamada SQLite. 
Houve, ainda, uma reformulação no suporte AML (Extensible Markup Language), 
que agora está baseado em uma outra biblioteca chamada Vibxml2. Veja mais detalhes 
sobre essas e outras mudanças no final deste apêndice. 
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PHP será uma linguagem orientada a objetos? 


É importante deixar claro que, apesar da grande reformulação dos recursos de 
orientação a objetos,o PHP continuará sendo uma linguagem procedural. O objetivo 
que levou a equipe de desenvolvimento do PHP a realizar essas mudanças foi tornar 
a linguagem mais competitiva em relação às aplicações J2EE (como, por exemplo, 
aquelas desenvolvidas com JSP — Java Server Pages) e NET. 


Uma aplicação JSP, por exemplo, é essencialmente um programa Java embutido. 
E, ao contrário do PHP, Java não é uma linguagem de script. O PHP é a linguagem 
ideal para o desenvolvimento de aplicações web, visto que esse é um ambiente ex- 
tremamente dinâmico. Em relação à sintaxe da programação orientada a objetos no 
PHP 5, é bastante parecida com a utilizada no Java. Por essa razão, os programadores 
que trabalham no ambiente J2EE não terão muitas dificuldades de adaptação. 


Conquistar os usuários que trabalham com a plataforma J2EE parece ser uma 
tarefa mais fácil do que conquistar aqueles que desenvolvem aplicações para a pla- 
taforma .NET, da Microsoft. Isso porque os desenvolvedores de aplicações .NET 
utilizam a linguagem ASP (Active Server Pages), já que esta é muito bem suportada 
por essa plataforma. 


Portanto, a forte ligação existente entre ASP e .NET seria um empecilho para 
fazer que esses usuários utilizassem outra linguagem. Nesse caso, o argumento 
a favor do PHP é que se o desenvolvedor optasse por utilizá-lo, seria muito mais 
simples realizar uma futura migração das aplicações, visto que uma aplicação PHP 
funciona nas principais plataformas disponíveis no mercado. Ou seja, o PHP não 
depende de um único fabricante. 


Compatibilidade entre as versões 4,5 e 6 


Em termos de compatibilidade, a maioria dos programas criados no PHP 4 pode ser 
utilizada sem problemas no PHP 5, visto que as principais funcionalidades da lingua- 
gem permanecem inalteradas. Porém, como a versão 5 possui novas características 
de orientação a objetos, alguns programas criados com esse tipo de programação 
em PHP 4 poderão deixar de funcionar. 


Para manter a compatibilidade com alguns programas da versão anterior, no PHP 
5 se manteve a diretiva register globals do arquivo de configuração php. ini, embora 
por questões de segurança não se recomende seu uso. Se habilitada, essa diretiva 
permitirá que as informações disponíveis a um programa PHP (dados de formulário, 
cookies, variáveis de ambiente e do servidor) sejam acessadas pelo próprio nome da 
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variável, em vez de utilizar os arrays superglobais do PHP (3 ENv, $ GET, $_POST, $ COOKIE 
e $ SERVER). Por exemplo, poderemos usar $nome em vez de $. POST["nome"]. 


Essa diretiva está desabilitada (valor 0ff) desde a versão 4.20 do PHP, pois pode 
levar um programador a deixar brechas de segurança, como a apresentada no pro- 
grama a seguir: 

<?php 

if (usuario autorizado) { 


tautorizado = true; 
} 
if ($autorizado) { 

include “conteudo. php”; 
} 


?> 


Veja que esse programa só existe um determinado conteúdo se o usuário tiver 
autorização para visualizá-lo, ou seja, quando a variável $autorizado for igual a true. 
Como nesse caso a variável Sautorizado não foi inicializada, qualquer pessoa po- 
deria chamar essa página passando esse valor como parâmetro pelo método GET. 
Exemplo: 


programa. php?autorizado=1 


Dessa forma, qualquer um que acessar o script dessa forma será autorizado a 
visualizar o conteúdo. 


A remoção definitiva da diretiva register_globals faz parte das mudanças do PHP 6, 
versão em desenvolvimento. Portanto, torna-se importante a não-utilização desta, 
evitando-se assim futuros problemas de compatibilidade. Isso significa que o PHP 6 
irá acabar com os sripts da era PHP 3, versão obsoleta há bastante tempo. 


Outra questão importante de compatibilidade no PHP 6 diz respeito ao uso dos 
arrays longos para o armazenamento de dados enviados por formulários, cookies 
etc. Ou seja, arrays como $HTTP_GET_VARS e $HTTP_POST_VARS deixarão de ser utilizados, 
permanecendo os arrays curtos $ GET, $_POST, e assim por diante. 


As principais novidades 


Orientação a objetos 


A partir da versão 5, o PHP passou a utilizar um novo modelo de objetos. Portanto, 
se você tem programas em PHP criados em versões anteriores com o recurso de 
orientação a objetos, possivelmente terá de fazer algumas modificações para que 
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continuem funcionando normalmente, O código responsável pela manipulação de 
objetos foi totalmente reescrito no PHP 5, apresentando um melhor desempenho, 
além de novas características. 


A mudança nesse modelo foi necessária porque, em versões anteriores do FHP, 
as características de OOP eram muito rudimentares. Os objetos eram manipulados 
como tipos primitivos (exs.: inteiros, strings). Dessa forma, ocorriam muitas cópias 
redundantes de dados, pois o objeto inteiro era copiado sempre que houvesse atri- 
buição a uma variável ou se esta fosse passada como parâmetro para um método. No 
novo modelo, os objetos não são referenciados por valor, mas sim por um handle, 
que pode ser visto como um identificador do objeto. A seguir, serão apresentadas 
algumas das novas características da OOP existentes no PHP 


Variáveis privadas e protegidas 


Com as palavras-chave private e protected podemos criar, respectivamente, variáveis 
privadas e protegidas em uma classe. Uma variável privada só poderá ser acessada 
pela própria classe onde foi declarada, enquanto uma variável protegida poderá ser 
acessada também pelas subclasses da classe onde foi declarada. Veja um exemplo: 


<?php 

class Classel { 
private $varl = "Olá, varinp"; 
protected Svar2 = “Olá, var21\n"; 
protected $var3 = "Olá, var3hn"; 
function bonDiaO) { 


print "Classel: ". Sthis->vart. "<br>": 
print “Classel: ". $this->var2. "<br>"; 
print "Classel: ", S$this->var3. "<br><br>": 


} 


class Classe? extends Classel { 
function bomDia®© { 


Classel: :bombia(); ff exibe 
print "Classe?: " . $this->var1. "<br>": // não exibe nada 
print "Classe2: " . $this->var2. "<br>"; // exibe 
print “Classe2: " , $this->var3. "<br>"; // exibe 


} 
k 
fobj = new Classel(); 
tobj->bomDia(); 
Sobj = new Classe? 0; 
Sobj->bomDia(); 
?> 
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Nesse exemplo foram criadas duas classes, chamadas Classel e Classez, e a segunda 
é subclasse da primeira. A variável $var1 foi declarada como privada (private), portanto 
só poderá ser acessada pela própria Classel. As variáveis $var2 e $var3 são protegidas 
(protected), portanto podem ser acessadas pela subclasse Classe2. 


Métodos privados e protegidos 


Uma classe pode conter também métodos privados ou protegidos. Da mesma forma 
que as variáveis, um método privado só pode ser acessado pela própria classe onde 
foi declarado, enquanto o protegido pode ser acessado pelas subclasses. Exemplo: 


<?php 
class Classel { 
private function MetodoPrivadoO { 
echo “Classel: :MetodoPrivado() chamado. <br>"; 
} 
protected function MetodoProtegido() { 
echo "Classel::MetodoProtegido() chamado. <br>"; 
tthis->MetodoPrivadoO ; 
; 
} 
class Classe? extends Classel { 
public function MetodoPublico® { 
echo "ClasseZ: :!MetodoPublico() chamado, <br>"; 
$this->MetodoProtagido(); 
l 
} 
$obj = new Classez; 


fobj->MetodoPublico(); 
?> 


Nesse exemplo, criou-se um objeto para a subclasse Classe?, e foi chamado o 
método MetodoPublico(). Esse método, por sua vez, chamado o MetodoProtegido() de 
sua superclasse, que, por sua vez chama o MetodoPrivado(). Uma chamada direta da 
Classe? ao método privado não iria funcionar. 


Classes e métodos abstratos 


Além de métodos privados e protegidos, podemos criar métodos abstratos. Isso 
significa que o método é apenas declarado, mas sua implementação não é fornecida. 
Isso será feito posteriormente em outra classe. Exemplo: 

<7php 


abstract class ClasseAbstrata { 
abstract public function teste); 
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ctass ClasseImplenentacao extends Classeabstrata { 
public function teste) { 
echo "Método teste() chamado! <br>": 
} 
} 
fobj = new ClasseImplementacao: 
tobj->teste O); 
7> 


Veja que a classe que contém o método abstrato também deve ser definida como 
abstrata, e não poderá ser utilizada para criar objetos diretamente. 


interfaces 


Outro recurso de OOP que temos à disposição é a criação de interfaces. Nelas, 
inserimos apenas as declarações dos métodos que farão parte da classe que irá 
implementá-la. É um recurso semelhantes às classes abstratas, Uma das diferen- 
ças é que uma classe pode implementar diversas interfaces. Utilizamos a palavra 
reservada implements para indicar que uma classe implementa uma determinada 
interface, Exemplo: 


<?php 
interface MinhaInterface { 
public function Teste(); 
} 
class MinhaClasse implements MinhaInterface { 
public function TesteO { 
i a 
} 


Definição de tipos de parâmetros 


Embora o PHP seja totalmente flexível em relação aos tipos de dados, podemos 
indicar-lhe qual o tipo de parâmetro que esperamos receber para um determinado 
método. Por exemplo, observe o código apresentado a seguir: 


<?php 

interface Interl £ 
function Teste(Interl $Inter1); 

} 

class MinhaClasse implements Interi { 
function Teste(Interl $Interl) £ 

f 

} 
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tobjl = new Minhaliasse; 
fobj2 = new Minhallasse; 
£objl->Teste($obj2Z); 

To 


Nesse exemplo, estamos indicando ao PHP que o parâmetro da função Teste deve 
ser do tipo Inter1, ou seja, um objeto da classe que implementa essa interface. Se 
o parâmetro passado não for desse tipo, será gerada uma mensagem de erro. Essa 
restrição de tipos é permitida apenas para classes ou arrays (desde o PHP 51),e não 
para os tipos embutidos da linguagem. 


A palavra-chave final 


Os métodos que forem declarados com a palavra final não poderão ser sobrescritos 
pelas subclasses. Exemplo: 


<?php 
class Minhallasse 1 
final function TesteO { 
Ha 
} 
} 


?> 


Nesse exemplo, se fosse declarado um método com o nome Teste em uma sub- 
classe de MinhaClasse, não iria sobrescrever o método declarado como final. Também 
é possível declarar uma classe como final. Exemplo: 


<?php 

final class MinhaClasse { 
tí 

ł 


T> 


Isso significa que ela não poderá ter subclasses. Portanto, a linha de código 
apresentada a seguir não iria funcionar: 


class QutraClasse extends MinhaClasse [> 


Construtores e destrutores 


Um construtor consiste em um método que será chamado toda vez que for criado 
um objeto da classe onde foi declarado. Portanto, pode ser usado para inicializar 
um objeto antes de ele ser usado. Ao contrário das versões anteriores, em que o 
construtor deveria possuir o mesmo nome da classe, a partir do PHP 5 esse método 
deve ser criado com o nome . constructQ). Exemplo: 
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<?php 
class Classe 1 
function — constructO { 
print "Este é o contrutor da Classe<br>": 


} 
class Subllasse extends Classe { 
function . constructO { 
parent::. constructi); 
print “Este é o contrutor da SublClasse<br>"; 


tobj = new Classe(); 


$obj = new Subllasse(); 
?> 


A vantagem dessa mudança é que se a segunda classe tivesse que ser movida 
para ser subclasse de alguma outra, não haveria necessidade de alterar seu código, 
já que todos os construtores estariam nomeados como . constructQ). Por questões 
de compatibilidade, se o PHP não encontrar o método . construct(), irá procurar 
um método que possua o mesmo nome da classe. 


Além de um construtor, uma classe pode ter também um destrutor, que deve 
ser nomeado como . destruct(). Um destrutor é o método que será chamado após 
a última referência feita a um objeto no programa, antes da liberação da memória. 
Exemplo: 


<?php 
class MinhaClasse { 
function — constructO) 1 
Sthis->nome = "MinhaClasse"; 
print “Este é o construtor da classe ". $this->nome. "<br>"; 
} 
function _destructO 1 
print "Este é o destrutor da classe ", $this->nome; 


Sob} = new MinhaClasse(); 
T> 


Um destrutor pode ser útil para fins de depuração, fechamento de conexão com 
banco de dados, entre outras tarefas. 
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Constantes 


Utilizando a palavra-chave const, podemos definir constantes dentro de uma classe. 
Para obter o valor de uma constante fora da classe, deve-se usar a sintaxe Classe:: 
Constante, como mostra o exemplo a seguir: 


<?php 
class MinhaClasse { 

const Constante = “teste”: 
} 


echo "O valor da constante é 
?> 


- MinhaClasse: Constante; 


Exceções 


Podemos implementar a manipulação de exceções utilizando as palavras-chave throw, 
try e catch. A idéia é separar os dados da aplicação dos erros. Uma execução é gerada 
com o comando throw. Os comandos try/catch são parecidos com o condicional if/ 
else, mas foram criados especialmente para o tratamento de exceções. Acompanhe 
o programa apresentado a seguir, que gera uma exceção quando o parâmetro estado 
não possui exatamente dois caracteres: 


<?php 
function buscaEstado (Sestado) { 
if (strlenCSestado) != 2) 
throw new Exception('O estado deve possuir obrigatoriamente 2 caracteres. '); 
Sestados = array C PR',' RIS, RS’, 5C CSP); 
if (in array(Sestado, festados)) 
return true; 
else 
return false; 
l 
// se o usuário não forneceu o parâmetro estado, inicializa com MG 
if {!isset($_GETẸ'estado'])) 
$_GET['estado']='MG'; 
/! tenta executar a função para buscar o estado 
try 
{ 
if (!buscaEstado($ GET['estado'D) 
echo "O estado ".4 GET["estado'].” não foi encontrado.”; 
else 
echo 4 GET['estado']." foi encontrado!" 


} 
catch (Exception $e) 
í 
echo (Se->getMessage()); 
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Esse programa recebe, pelo método GET, um parâmetro chamado estado. Se o 
parâmetro não for fornecido, será assumido o valor “MG”. Se for fornecido, será 
chamada a função buscaEstado() para verificar se o estado é válido, Nesse exemplo, 
os valores válidos são PR, RJ, R$, SC e SP. 


Se o estado possuir dois caracteres, a função irá retornar verdadeiro (true) ou 
falso (false), indicando sua validade. Caso contrário, a execução da função será 
interrompida devido à geração de uma exceção, e serão executados os comandos 
definidos no bloco catch. A classe Exception é predefinida pelo PHP. Supondo que 
esse programa seja nomeado como estado. php, veja a seguir três possíveis chamadas, 
assim como os resultados gerados por cada uma delas: 


estado. php?estado=R$ (retorna true) 
estado, php?estado=AC (retorna false) 
estado. php?estado=TESTE {gera uma exceção) 


Variáveis e métodos estáticos 


As variáveis estáticas (precedidas pela palavra static) agora podem ser inicializadas, 
como mostra o exemplo a seguir: 


<?php 
class Classe { 

static $variavel estatica = 10; 
} 


print Classe: :Svariavel estatica; 
?> 


Além disso, a palavra static também pode ser usada para definir um método 
como estático. Dessa forma, é possível chamá-lo mesmo sem a criação de um objeto 
para a classe onde foi declarado. Exemplo: 

<?php 


class Classe { 
public static function MetodoEstaticol) { 


PÉ a 
} 
} 
Classe: :MetodoEstatico(); 
?> 


A palavra-chave “instanceof” 


Pode ser utilizada para testar se um objeto é instância de uma determinada classe. 
Por exemplo, o código a seguir testa se o objeto $a é uma instância da classe Minha- 
Classe: 
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<?php 

class Minhallasse { + 

$a = new MinhaClasse; 

if (Sa instanceof MinhaClasse) { 
echo "É um objeto da classe!"; 


} 


7> 


Outras mudanças na 0GP 


Neste apêndice, foram apresentadas as principais mudanças ocorridas na programa- 
ção orientada a objetos no PHP Para obter mais informações sobre essas e outras 
alterações na OOF, consulte o site oficial do PHP (http: / /wm. php.net), onde se encontra 
disponível uma página que lista as características da Zend Engine 2. 


SQLite 


Outra novidade que surgiu no PHP 5 foi o SQLite, uma ferramenta SQL embutida. 
Os programas que acessarem o SQLite poderão trabalhar com bancos de dados SQL, 
sem que haja necessidade de ter um SGBD (como MySQL ou PostgreSQL) instalado. 
À biblioteca SQLite lê e grava dados diretamente em arquivos de bancos de dados 
no disco. Portanto, o SQLite é uma boa alternativa para quem precisa de velocidade 
e não necessita de todos os recursos oferecidos pelos SGBDs mais “pesados” 


Mais informações sobre o SQLite podem ser obtidas em http://sglite.org. Veja a 
seguir um exemplo de programa PHP envolvendo a criação de uma tabela, inserção 
de um registro, consulta e tratamento dos resultados: 


<?php 
if ($db = sqlite open('meubancosglite', 0566, Serro)) 
{ 
sqlite_query($db, CREATE TABLE emails (email varchar(80))'); 
sqlite_query($db," INSERT INTO emails VALUES ('julianoêniederauer.com.br')"); 
$res = sglite_query($db,'select * from emails); 
Sarray = sqlite_fetch_array($res}; 
foreach (Sarray as $chave=>$valor) 
echo "Schave => Svalor<BR>"; 
salite close ($db); 
l 
else 
die (Serro); 
?> 
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Suporte XML 
Até a versão 4 do PHP, o suporte XML era baseado em três bibliotecas de terceiros: 
* A Expat, de James Clark, para a criação de um parser SAX. 
"A libxml, do projeto Gnome, para a criação de um parser DOM. 
"A Sablotron, da Ginger Alliance, para transformações com XSLT. 


Como são desenvolvidas por três fornecedores distintos, aumenta bastante a 
dificuldade de manutenção dessas bibliotecas por parte da equipe de desenvolvi- 
mento do PHP. Além disso, apesar da Expat ser estável e sofrer poucas mudanças, 
ainda possui limitações em sua funcionalidade. 


A partir do PHP 5, o suporte a XML foi totalmente modificado. Nessa versão, 
todas as extensões são baseadas na biblioteca libxml2, do projeto Gnome. Você irá 
encontrar mais informações sobre essa biblioteca em http://ww.xmlsoft.org. Trata-se 
de um passo importante para o PHP se tornar uma das linguagens mais eficientes 
para a manipulação de documentos XML na web. 


Outra novidade da versão 5 foi a inclusão de uma nova extensão chamada 
SimpleXML, que permite fácil acesso e manipulação dos dados XML por meio de 
objetos do PHP 


Outras mudanças 


Além das mudanças apresentadas neste apêndice, o PHP 5 trouxe mais algumas 
novidades, como o aperfeiçoamento do suporte a streams, remoção da biblioteca 
embutida MySQL, melhora no desempenho de algumas funções, acréscimo de fun- 
ções em alguns módulos e correção de diversos defeitos (bugs). Para estar sempre 
atualizado em relação às mudanças ocorridas nas últimas versões do PHP, consulte 
periodicamente a lista de mudanças (ChangeLog) publicada após o lançamento de 
cada versão no site http: / ve php.net, 


Novidades do PHP 6 


O PHP 6 já possui uma série de atualizações sendo discutidas nos fóruns de de- 
senvolvedores web. Confira a seguir as principais novidades desta versão 6, assim 
como uma breve explicação sobre cada uma delas. 
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Suporte a Unicode 


Muitos programadores enfrentam constantes problemas com codificação de ca- 
racteres (character encodings). Se você trabalha com acesso a bancos de dados, 
provavelmente já deve ter passado por problemas semelhantes, onde, ao ler os dados 
do banco, aparecem diversos caracteres estranhos em vez do texto com acentuação 
que esperávamos. 


Apesar de o Unicode não ser uma codificação tradicional (como, por exemplo, 
UTF-8 e IS0-8859-1), o suporte a esse padrão no PHP 6 promete acabar com o 
problema, permitindo a criação de aplicações cada vez mais internacionais. 


Unicode é um padrão desenvolvido pela Unicode Consortium, uma organiza- 
ção sem fins lucrativos, o qual permite aos computadores representar e manipular 
texto de qualquer sistema de escrita existente. Seu sucesso em unificar conjuntos 
de caracteres levou a sua implementação em várias tecnologias importantes no 
mercado, como XML, Java e diversos sistemas operacionais. 


A idéia do Unicode é fornecer um único número para cada caractere, não im- 
portando a plataforma, o programa nem a linguagem utilizada. Esses números são 
chamados de codepoints. 


Por exemplo, a letra A é identificada pelo número 65, a letra B, pelo número 66, 
e assim por diante. Ou seja, podemos ver o Unicode como uma grande tabela. 
Portanto, não confunda Unicode com as codificações tradicionais (encodings), pois 
estas apenas codificam um codepoint em bytes. 


No PHP, os parâmetros de configuração Unicode estão disponíveis no arquivo 
php. ini. Entre eles, temos a diretiva unicode. semantics, que pode ser habilitada ou não, 
de acordo com a necessidade do usuário. Dessa forma, se não estiver enfrentando 
problemas de codificação, o usuário poderá manter O recurso desabilitado, confe- 
rindo um certo ganho de performance a sua aplicação. 


Outros parâmetros de configuração, assim como a documentação inicial do 
Unicode no PHP, podem ser consultados em: 


http://www. php.net/manual /en/ref .unicode, php 


Remoção de funções obsoletas 


Além da eliminação da diretiva register_globals (conforme citado no início deste 
apêndice), passam a não existir mais as funções marcadas como obsoletas (depre- 
cated) nas versões 3 e 4 do PHP. 
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Isso significa que os scripts muito antigos irão parar de funcionar, exigindo que 
os programadores revisem e reescrevam seus códigos. Essa operação de “enxuga- 
mento” tem como objetivo tornar a linguagem mais simples e prática. 


Aliases de funções 


Muitos aliases, ou seja, apelidos utilizados para algumas funções (por exemplo, 
mysql fieldname é um alias para mysql. field name) serão removidos. Portanto, scripts que 
utilizam esses nomes alternativos precisarão ser alterados para funcionar na nova 
versão do PHP. 


Trata-se de uma simplificação importante, pois o uso de apenas um nome para 
representar cada função ajuda a reduzir a complexidade do desenvolvimento e do 
próprio código da linguagem de programação. 


Eliminação de magic quotes 


As funções do tipo magic. quotes. *, até então utilizadas para acrescentar caracteres 
de escape aos dados recebidos pelos scripts PHP, também foram eliminadas. Essa 
mudança deve ocasionar pouco impacto sobre a plataforma, visto que a maioria 
dos programadores PHP sequer utiliza essas funções. 


Fim do Safe Mode 


A chegada do PHP 6 elimina também o Safe Mode (modo seguro), que foi uma 
tentativa de resolver, em nível de PHP, os problemas de segurança em servidores 
compartilhados. Assim, fica mantida apenas a diretiva open basedir, responsável por 
limitar os arquivos que podem ser abertos pelo PHP em uma determinada árvore 
de diretórios. 


Orientação a objetos 


No que diz respeito à orientação a objetos (OOP), no PHP 6 se adicionou o suporte 
a namespaces, também chamados de contextos. Esse recurso facilita a organização 
lógica dos scripts e a manipulação das classes com nomes longos, existentes nas 
bibliotecas para PHP. Por exemplo, imagine uma classe nomeada como: 


PEAR Form Loader Validate Table Element Validator Exception 


Além de ser cansativo ficar repetindo o nome dessa classe a cada utilização, o 
código ficaria mais longo e difícil de analisar. 
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Veja um exemplo de definição de um namespace. O comando de declaração 
deve ser o primeiro do arquivo: 


Zend/DB/Conexao.php: 


<?php 

namespace Zend: :DB; 
class Conexao į 

} 

function conectar) { 


} 


T> 


O mesmo namespace pode ser usado em diversos arquivos PHP. Assim, todas 
os nomes de classes e funções serão automaticamente prefixados com o nome do 
namespace. Dentro do namespace, os nomes locais são precedentes em relação aos 
globais. 


A referência a classes e funções de um namespace deve incluir seu nome completo, 
como mostra o exemplo a seguir: 


<?php 

require 'Zend/DB/Conexao.php'; 
$x = new Zend: :DB:: Conexao; 
Zend: :DB:: conectar); 

7> 


Podemos ainda importar um namespace ou o nome das classes como aliases. 
Observe o exemplo: 


<?php 

require 'Zend/Db/Conexao. php" ; 

import Zend::DB; 

import Zend: :DB::Conexao as ConexaoBD; 
$x = new Zend: :DB: :Conexao(); 

ty = new DB::Conexao(); 

$z = new ConexaoBD() ; 


DB::conectarO); 
7> 


Neste código, foram utilizadas três formas diferentes para criar objetos da classe 
Conexao, que foram atribuídos às variáveis $x, $y € $z. 


Perceba que o comando import é usado para a criação de aliases (apelidos) para 
as classes e namespaces. Se não for especificado um alias, será considerado o último 
nome. Por exemplo, import A::B::C::D é o mesmo que import A: :B: :C::D as D, 
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O comando import deve ser usado apenas em escopo global, tendo efeito desde 
seu ponto de definição até o fim da página. Além disso, é válido apenas no arquivo 
onde foi definido. O ideal é executá-lo sempre no início da página. 


Existe também o namespace vazio (com o prefixo ::), que identifica classes e 
funções no escopo global. Logo, sempre que utilizarmos :: antes do nome de uma 
classe ou função, o PHP irá procurá-la diretamente no escopo global, e não dentro 
de um namespace. Por exemplo: 


<?php 

namespace Juliano; 
teste); 
nteste()! 

?> 


Neste código, a chamada teste() tenta localizar primeiro a função dentro do 
namespace Juliano, enquanto a chamada ::teste() busca diretamente a função no 
escopo global. 


Temos ainda a constante NAMESPACE, que indica o namespace corrente (em es- 
copo global, contém uma string vazia). Podemos utilizá-la na chamada de funções 
callback, como mostra o exemplo: 


<?php 

namespace AL:B::C; 

function teste() 1 

} 

set_error_handler{ NAMESPACE . "::teste"); 
7> 


Apêndice C 


Links interessantes 


Acessando os links apresentados a seguir, você poderá se aprofundar ainda mais no 
estudo da linguagem PHP e de outras tecnologias. São sites que oferecem tutoriais, 
scripts gratuitos, documentação detalhada e diversas outras ferramentas úteis para 
o desenvolvimento de sites dinâmicos e interativos. 


Site oficial do PHP 


= http://waw.php.net 


Neste site você encontra toda a documentação e o código do PHP, além das 
novidades e as versões mais recentes para download. 


Scripts, programas e tutoriais PHP 
= http://www. phpbuilder. com/ 
Apresenta grande diversidade de recursos para O PHP. 
= http://en.wikipedia.org/wiki/List of. PHP editors 


Apresenta uma lista de editores que você pode usar para editar seus programas 
em PHP. 


= http://www. phpclasses.org/ 


Um repositório de classes em PHP. 
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a http://px.sklar.com/ 


Apresenta muitos exemplos de scripts e funções úteis. Possui um bom meca- 
nismo de busca para você encontrar as informações facilmente. 


= hrtp://wmw.weberdev. com/ 


Apresenta artigos, fóruns, tutoriais, scripts etc. 


Catálogos de links PHP 
= http://ummhotscripts.com/PHP/ 
Apresenta artigos, livros, revista, scripts, softwares etc. 
= http://php.resourceindex, com/ 


Apresenta grande diversidade de recursos PHP, incluindo documentação, 
scripts completos e funções. O site é todo dividido em categorias e possui 
uma ferramenta de busca para que você encontre facilmente as informações 
desejadas. 


Outros links 

= http://ww.mysql. com 
Site oficial do MySQL. 

" http://www. postgresql .org/ 
Site oficial do PostgreSQL. 

= http://www. apache.org 
Site oficial do Apache. 

= hrtp://mw.zend.com 


Site oficial da Zend Technologies. 
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